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UltraChat 

Entertainment Chat System 

Version 1.0 
User Manual 

An Option Module for TBBS Version 2.2 

by Bob Hartman 
and Philip L. Becker 

Copyright © 1994 by Philip L. Becker, Ltd. 
All Rights Reserved 



WARRANTY 


UltraChat is manufactured by eSoft, Inc* We have made every 
cllort to provide Lhe user with error-free data diskettes. Should 
there be difficulty in transferring the data from Lbese diskettes to 
your operating system diskette, contact us at (303) 699-6565 (voice) 
for replacement. 

UllraCbat is distributed on arri'AS IS" basis only, without warranty. 
Neither eSoft, Inc. nor its authorized dealers shall have liability or 
responsibility to any person or entity with respect to liability, loss, 
or damage caused or alleged to be caused by this software. This 
includes, but is not limited to, any interruption of service, loss of 
business or anticipatory profits, or consequential damage resulting 
from the use of this software. 


eSoft SOFTWARE SUPPORT 

eSoft, Inc,, provides a 24-houT-a-day multi-line support BBS service 
to registered TBBS system owners at (303) 699-8222 (eSoft 
Software Support BBS - speeds up to 28,800 bps supported). We 
strongly urge that this telecommunications system be used for error 
reporting and troubleshooting assistance. Because all system cor¬ 
rections will be distributed first via the eSoft Software Support BBS, 
wc recommend that all registered licensees log on to the Support 
BBS at least once a month to receive latest system update informa¬ 
tion. (At your first logon, you will need to register the serial number 
of your TUBS master disk(s) and supply a password, which will be 
approved for full support access during the next working day. 
Other information is given online during the registration process.) 

The Ultra Chat software is distributed without copy prevention 
protection, since we feel that such protection drastically reduces 
the utility of a program and punishes most the honest purchaser. 
We do, however, oqicct purchasers of UltraChat to honor their 
license agreement. This software is copyrighted, and licensed to 
the purchaser for your individual and exclusive use on a single CPU 
at a time. Any reproduction for use by other persons is n violation 
of our copyright and your license agreement. 


THIS SOFTWARE IS NOT FOR SALE 


eSoft, Inc. does not “sell” UltraChat. It seUs only the media it is 
contained on. Jt licenses you the use of the software only under the 
following license terms and conditions. 


License Agreement _ 

Carefully read the following terms and conditions. Use of this 
product constitutes yonr acceptance of the terms nod conditions, 
and your agreement to abide by them subject to paragraph7 below. 

1. This is an end-user license. You, the original purchaser, are 
granted this license for the use of the UltraChat software under the 
terms Mated in this agreement. You may not assign or transfer the 
software or this license to any other person without ihe express 
written consent of eSoft, Inc. Any attempt to sublieense, assign, or 
transfer any of the rights, duties, or obligations bcrcundcr is void, 
ebofl, Ire. does allow you to transfer this license under the condi¬ 
tions outlined on your registration form. This procedure cou- 
sti Lutes express written consent under this provision if it is followed 
properly. 

2. The UltraChat software Is copyrighted material. Once you have 
paid the required single copy license fee, you may use the software 
as long as you like provided you do not violate the copyright or any 
of the following conditions, 

3. Single CPU License. You may use the software on any computer 
for which it is designed so long as il is not in use on more than one 
computer at the Fame time. You must pay for additional licenses if 
you want to u*c this software on more than one computer at the 
same lime. 

4. Backup Copies. You may make as many backup copies of the 
software as you require to avoid loss. You are responsible for all 
backup copies you make, and must assure they do not result in any 
use of the software which would conflict with the provisions of 
paragraph 2 above. 



5. Software Modification. You may noi make any changes or 
modifications to Lhe Licensed software not expressly authorized by 
eSoft, Inc., Philip L. Becker, Ltd, or their agents. This includes but 
is not limited to disassembly and reverse engineering the software. 
The single exception granted under this license is the changing of 
text strings in Ihe programs for customized presentation. 

6 . Federal Government. This Software is Commercial Computer 
Software under the Federal Government Acquisition Regulations 
and agency supplements to Ihem. The Software is provided to the 
Federal Government and its agencies only under the Restricted 
Rights Provisions of the Federal Acquisition Regulations ap¬ 
plicable to commercial computer software developed at private 
expense and not in the public domain. 

7. Yon may refuse to abide by this license by returning all materials 
within 30 days, along with a written statement that yon Itave kept no 
copies of the software or documentation. This statment must be 
signed by you and becomes a legally binding statement that you have 
indeed destroyed any backup copies you may have mode in those 
thirty days. If you keep the materials beyond the 30 day period, or 
refuse to assure that you have not kept any copies of the software 
or its documentation, then you arc fully bound by this agreement. 

Q. Limitation of Liability'. In no case shall the Liability of eScifl, Inc. 

or Philip l, Becker, Ltd. exceed the license fees paid for the right 
lo use this software or One Hundred Dollars ($100.00), whichever 
is greater. 

9, Dual Media. This software is provided on dual media for your 
convenience. The software on both, types of disk media is identical, 
and is covered by this single license. You are not authorized lo 
distribute the “spare” disk to another party 1 . 

10. This agreemen t may not be modified except by a wril t cn i ostrument 
signed by eSoft, Lac. This license constitutes the entire agreement 
and understanding between 31)11 and eSuft, Inc., and supersedes any 
prior agreement or understanding whether oral or written relating 
to the subject of lbisLicen.se. 
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An Introduction to UltraChat 


4 What you hold in your hands is The most powerful entertainment 

m chat software ever developed for use on bulletin board systems. 

UltraChat is the product of over a year’s worth of design and 
3 development, representing tens of Lhousstnds of man hours of 

• effort. UlimChat brings tlie configurability for which TBBS is 

' known to the chat arena, offering unparalleled flexibility and con- 

^ troh Like TBBS itself, UltraChat is a complex product that requires 

time, effort and patience to master fully. The benefit lo you and 
yuur users is clear - UltraChat can be made to look and function 
like the chat facilities of virtually any BBS. You can even design 
- your own t otally u tuque chat system, with the fun ctio us, keysLr uke s, 

prompts and responses yen choose. 

UltraChat is shipped to you with several sample configurations that 
should be suitable Cor virtually any operating BBS. By simply install- 
^ ing "UltraChat and one or more of the sample configurations, you 

' can begin offeri ng the benefits of UItraChal with a minimal amount 

of effort. Then, as your schedule and level of inclination allow, you 
can begin rapping UltraChat’s more advanced features and con¬ 
figurability options. 

pj Thank you for selecting UltraChat. We hope you and your users 

enjoy the product us much as wc enjoyed bringing iL to you. 


IMPORTANT: Make sure you view the README.DOC 
file, located In the root directory of the release disk, for 
late-breaking Information, corrections, and other im¬ 
portant details which are not reflected In this manual. 
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Installation of UltraChat 


UltraChat installation consists of the following steps: 

1. Physically copy the software onto your hard disk, 

2. Reference UltraChat on the TBBS command linn 

3. Install the supplied patch to TBBS using UPDATE (if you’re 

running TBES Version 22). Please note that UltraChat will 
not run on versions of TBBS earlier than nor will it run 

on single line versions of TBES. 

4. Create a directory for temporary UltraChat files 

5. U sing the. supplied UltraChat configuration file (or after you 
create your own) compile the configuration using UltraChat 

6. Set up your TBBS menus to access UltraChat 

Now let’s look at each of these steps in detail... 

To install the UltraChat option module, copy all files from the root 
directory of your UltraChat release disk into Ihe TBBS sub-direc¬ 
tory on your hard disk. 

Next add the following command line switch to your MLTBBS 
command line: 

/OiUCHAT 

If yon already have option modules installed on your TBBS (such 
as TDBS or S YSOM) then simply add the reference to UltraChat 
at the end of the list, like so: 

i O lT DB SOM,SYSOM,UCHAT 

This will ins lull the UltraChat option module. Note: If you receive 
the error message “Not enough memory” when you rim TBBS you 
should change to using /OX Lo load option modules into EMS 
memory. In the shove example this would he: 

/OX:TD BS OH,SY S OM,UC HAT 
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Next, ONLY IF YOU ARE RUNNING TBBS VERSION 22, use 
the UPDATE program (available tom the cSoft Support Board if 
you do noL already have a copy) to apply a special patch to TBBS 
that allows UitraChat to better integrate into your TBBS system, 

From DOS. in yonr TRRS directory (where 1J PDATE.EXE should 
be placed), type Lh© following: 

UPDATE ALL /UiUCHAT-BlN 

UPDATE will run, report some status messages, and indicate that 
it has completed updating your TBBS. MI )TE: Versions of TBBS 
later than 2.2 do noL require this update. 

Next, create a directory that will be used for UitraChat’s temporary 
data Fle.s. Tf you have a large RAM dish, UllraChat performs best 
if tliis. directory is placed on a RAM dish drive. This directory 
should be capable of holding at least 16k per line that your system 
runs, so a 04 line system would require a directory that can hold 
approximately 1M of data. This directory name will be used in your 
IJCHAT.CTL File as the UCHAT DIR directory (a configuration 
statement discussed later on). 

Next, compile the supplied UllraChat configuration file. Compiling 
means that the configuration for UitraChat, created and manipu¬ 
lated as a text file, is copied in a special formal to a new file that 
UllraChat can use online; the configuration file must be compiled 
before UitraChat can run. You will probably wish to at least look 
at this file before compiling it. YOU WILL NEED TO CUS¬ 
TOMIZE THIS FILE TO SOME DECREE BEFORE MAKING 
ULTRACHAT AVAILABLE TO YOUR USERS! If you wish to 
simply test and “play’' with UitraChat, compile the supplied sample 
and come buck lu configuration later. Configuring UitraChat is 
covered elsewhere in this manual. 

To compile, from DOS, in your TBBS directory type the following: 
UCHAT COMPILE 

Various status messages wilt be displayed, and it should indicate 
that compilation was completed without error. (If you have made 
changen, and the file no longer compiles, check your changes to 
make sure they are formatted properly; refer to the appropriate 
sections of this manual for help.) 
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HINT: If you insert Lhe UCHAT COMPILE co mman d in your 
RUNBBS.BAT batch file Just prior to the MLTBBS command you 
will insure Oral Lhe UltraChat configuration is compiled and current 
each time TBBS runs. 

Finally, set up menus in TBBS for Ultra Chat as described beginning 
on page 1-6. 


Option Modules and Memory Usage _ 

When you install an option module such as UllraChal, the total 
memory required by your TBBS system will increase. This increase 
occurs in two areas: 

♦ Space to put the UitraChal software itself 

♦ Space to put data manipulated by UltraChat 

The UltraChat software itself normally resides in base (convention¬ 
al) memory. This is the initial 640k of memory installed in. a PC 
compatible. Therefore, more conventional memory' is needed to 
store UltraChat. This is called OM CODE (for option module 
code) and is the UltraChat software application itself. 

The data manipulated by UltraChat is called OM UDATA (for 
option module user data). There is one section of OM (JDATA 
(called a segment) for every line defined in TBBS — whether the 
line is used by a caller or not. This memory can be located in base 
memory, in EMS (expanded) memory, or in a combination of both. 

UltraChat requires the following additional memory: 

OM CODE memory: GO,000 bytes (pi uft 600 bytes per line) 

OM UDATA memory: 48,000 bytes per user conventional 

nr 48 kbytes per user EMS 

OM UDATA memory is shared with other option modules, such 
as TDJBS, SYSOM, etc, The size of the OM UDATA will be no 
larger than the largest size requested by any one option module you 
have installed. The following illustration show's this concept: 
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c ie 32 4$ kbytes Sf OM UUATA Memcfy 


“ho largest amount of OM IJDATA memory required 
by any cna option nrocule Is tbs naxinum 
airojrt needed by all coirbined 

When There's Not Enough Memory Available _ 

You may he unable to load your TBBS system after instailing 
Ultra Chat due to inadequate available memory. Assuming you have 
CMS (expanded) memory installed in your machine (commonly 
done with utilities such as QCMM } 386M&X, etc) Lhen you are most 
likely running out of base (conventional) memory. To help work 
through this situation, TBBS offers a technique called option 
module code stacking On 386, 486 and Pentium based PCs that 
implement true LtM 4.0 EMS memory, TBBS can “stack” option 
modules on top of each other into EMS memory. 

To enable option module code stacking in TBBS, simply change the 
/O: MLTBBS command line switch to/OX: like so: 

/OX:TIMS,TDBSOM,SYSOM,QSO,ICHG 

With option module code stacking, the amount of conventional 
memory used for op Lion module code (DM CODE) is no larger 
than the largest single option module you have installed (usually 
TDBS), No matter how many option modules you install, no addi¬ 
tional conventional memory will be used - the OM CODE will be 
loaded into EMS memory Ins Lead. The following illustration shows 
this concept: 




Chapter 1: Installation 



Of course, you must ensure, that you have enough EMS memory 
installed and available before option module code stacking can 
work. If TBBS still fails to load after enabling code stacking, then 
check to make sure you have enough memory’ installed in your PC, 
and that your memory manager is configured properly to use the 
memory as EMS. 


Adding UltraChat to TBBS Menus _ 

When the UltraChat optiou module is installed, a new command 
type, becomes available for use in TBBS menus. This command is 
like any other TBBS menu command and may be used in any menu, 
as you wish, The new’ command is: 

Type = 203 

There are several Opt DaLa switches available that control the 
behavior of UltraChat. They are described elsewhere in this 
manual 

As with all TBBS commands, the Type 203 command may be used 
in as many different menu entries and in as many different forms as 
you wish. All normal TBBS security occurs through the privilege 
levels and access flags as it does with any TBBS menu entry. 
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UltraChat Initialization 

UltraChat is unique in that it must be “initialized'’ each time a User 
connects to the system. To do this, you must execute UltraChat 
from an auLo-exec tiling menu entry in your lop level menu, (KXX), 
and then puss control to anolher menu. This illustration shows the 
concept of how this is done: 

OLD WAY... NEW WAY... 


MENUDQQO 
< 1 > Func 
<2* Func 


MENUDDOO 
■'© I nil U«ha( 

QijIc TOP 

i 

i 

V 

NEKUTOP 
< 1 '* Fum; 
■=2> Finic 


You may already have a structure like this in place. If you do not, 
then to change tu the new structure, follow these steps: 

• Rename your 0000 menu in TBBS to TOP by using the 
DOS command: 

REN MEWITO 0 Cl 0 .CTL MENUTOP. CTL 

• Create a new 0000 menu with MEDIT or SDL 

• In Lhis 0000 menu first place un auto-executing menu 
entry to initialize UltraChat 

• In this 0000 menu next place an auto-executing menu 
entry of Type = 35 and Opt Data = TOP to transfer tn 
your original TOP level menu and set iL fur Lhe duration 
of the call as the top level menu. 

NOTF; If you operate in multilingual mode, or have the RIP Kit 
installed, you will need to duplicate tins hi-level incmiing structure 
for each of the languages yuu have installed: menu 0000 for lan¬ 
guage A, menu UULB for language B, menu 00LC for language C, 
etc. To iniliaK;ze UltraChat, the auto-executing menu entry in the 
newly created 0000 should have Lhese characteristics: 

Type=203 ; Execute UltraChat 

OptData=/l j /Imeans "initialize" 
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Here is what such a menu would look like in SDL: 

Menu: 0000 
Entry: 

Key='"$ Type*=2 03 Opt Data=/I 
Entry: 

Key= A # -Type^S Opt Data=TOP 
BndMenu t 

This menu will initialize UllraChat, and force the user to enter their 
three-line “bio” information if they have not entered it previously. 

Yon can initialize UitraChat as shown, or if you. prefer, you. can use 
one of several optional forms of initialization by using these Dpi 
Data switches: 

/Lt 

This is the same as /I, except that a user is not required to fill out a 
Lhree-line bio, useful for systems that do not allow chat access until 
after a user is a member. 

/I:2 

This is the same as /I, except that a "logon announcement” is not 
generated, useful for systems not wishing to have logon an 
nouncemenis. 

fl'.3 

This initializes the user without checking for a three-line bio, and 
without generating a logon announcement. 


Accessing UitraChat 

Once UitraChat Is installed and set to initialize each time a user 
logs into the system, you need to provide TBBS menu entries for 
people to use. the chat features. 

To allow a user to enter UitraChat, create a menu entry where 
desired with the following characteristics: 


1-fi 
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Type*2 0 3 j Exe c uto u 1 tr ach at 

Opt Data=/E :2 ; /E means "enter" 

Here is whaL such a menu entry might look JiTce in SDL: 

Entry: <c>hat Access 
Key=c Type=203 opt Data=/E:2 

You can allow entry to UltraChat as shown, or if you prefer, you 
can use one of several optional forms of entry by using these Dpt 
Data witches: 

/E:l 

Allows entry “Oracomm style" where all lines in use are listed, and 
a user receives a question aboul whether they waul private, public 
or sysop chat, 

/E:2 

Allows entry directly to the lowest channel number allowed with no 
question asked whatsoever. 

;E:3 

Allows entry "DLX style” where the user enters directly to public 
chat, but is prompted as to which channel Lhey wish to enter, 


/E:4 


Allows entry directly to the last channel Lhe user was in, if they can 
still go there. If they cannot go there, they are placed in the lowest 
numbered channel configured. Note this type of entry cannoL return 
a user to private one on-one style chat; only a chat channel (whether 
public or private). 

/E:5,# 

Allows direct entry to a specific channel number. The 4 parameter 
Is the public chat channel number U> enter. This can be used as a 
way to force differ ent people into different chat sections, and it you 
do not provide a channel change command, to prohibit them from 
moving about. 
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/E:6,# 


Allows direct entry to a named conference. The # parameter is the 
named conference identifier, and roust match a defined named 
conference. Refer to the DEFINB^CONF configuration statement 
(discussed later on) for details on defining a named conference. 


Forcing the Use of Handles Within Chat 

You can force users to use a handle - a name different from their 
user name or ID - within the chat environment, (Refer to tbc 
glossary in Appendix A for more information on handles.) 

Whenever you want to foroc the use of handles, simply add the /H 
switch lo UltraChat’s Opt Data line. 

IMPORTANT; Although not a requirement, the /H switch, is best 
used when Ultra Chal is initialized (see the /I switch, above). This 
will force a user to enter a handle before the logon announcement 
is issued. 

Here is what an initialization menu entry might look like in SDL 
when handles are forced: 

Entry: 

Key= A £ Type-=203 Opt Data=/l /H 


Separating Users Into Groups 

In many cases, you may wish to logically separate users into unique 
groups for Lhe purposes of Ultra Chut related functions (chat, who’s 
online displays, three-line bio lookup, and so on). For example, if 
you operate a single BBS with a general public section, and a user 
club section, you might not want users of one part of the system to 
interact with users of the other part(s). UltraChat provides group 
capabilities to allow- this separation. Refer to the glossary in Ap¬ 
pendix A for more details about groups. 

To place a user within a group, use this switch: 


!Q\< id> 
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This Opt Data switch marks a user as be mg a member of a particular 
group, where <id> is the group identifier. The group identifier 
may be any string of four (4) characters or less. When a user is 
assigned to a group, they cannot perform any UltraChat functions 
directed at users outside of their group. The only exception is the 
special group < id > of “ 0 ” that essentially removes the user from 
a group. This is also the default group; should you not use vbe/G: 
switch, all users arc in the same group. 

This swilch is particularly useful in conjunction with the /i initializa¬ 
tion switch to mark a user as a member of a group from the moment 
they login to the system. (When used this way, the f(3: < id > switch 
must be used before the /I in the Opt Data, as shown below.) 

SDL menu example (at initialization): 

Entryi 

Key=~fj Type=203 opt pata=/G iBA.se /I 

Note that you may configure up to 250 groups, plus the default “all 
included” group, 


Passing Parameters to UltraChat 

UltraC’hat allows you to pass parameters - text information - from 
the menu entry to UliriiChal upon entry to the chat environment, 
These parameters can then he used to dynamically change Ultra- 
Chat behavior based on the parameter^) passed. 

To pass a parameter, use the Opt Data switch; 

/P<#>: < si ring > 

Where < #> is a number between 1 and 9, and < siring > is any 
text siring enclosed in single or double quotes. The parameters you 
pass in this fashion can then be used by the Ultra Chat configuration 
file to change the behavior of UltraChat for a particular user or 
group of users. 

Here’s ait example of parameter passing in an SDL menu entry: 
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Entry? 

<M>ajor BBS- Chat Emulation 

Key=M Type-203 opt oata=/Pls" mbbs" /e:2 

This would pass the string “MDBS” as parameter 1 to UltraChat. 
Within the UltraChat configuration file, you can use the P# restrict 
type in conjunction with RESTRICT blocks to control configura¬ 
tion based on a passed parameter. For example llr5 parameter 
causes UltraChat to emulate a Major BBS system’s chat facilities 
with the sample configuration file supplied. Refer to the section 
“Restricting Configurations Within UltraChat” later in the manual 
for details. 


“One-Shot" Access To UHraChat Functions 

UltraChat allows you to create menu entries that directly access a 
single chat command and then. Totum to the TBBS menu. This Is 
called a “one-shot” since the function is executed singly and then 
Ultr aChat exits. To create such a menu entry use Opt Data switch: 

/C: < string > 

The c string> is sent to UltraChat and is executed exactly as 
though the user had entered chat and then typed in the siring, 
Therefore, the < string > needs to consist of a command that is 
valid and legal for that user. To ensure that UltraChat correctly 
extracts the command place the siring in single or double quotes. 

SDL menu examples: 

Entry 1 

cs>end a Kessage to Another: user 
Key=S Type=203 Opt Data-/Ci"/T" 








r* 



/“ 






Entry: 

<p>age the Sysop 
Key=P Type-203 

Opt Data=/C?"/T Sysop Please come chatl" 

NOTE: In the above example, the/T command is the “Oracomm 
style” uommund to send a message to another user; these examples 
assume a configuration that is “Oracomm like,” 
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Suppress Keystroke Request on Chat Exit 

When yon execute an UltraChal “one-shor (refer to the /C: switch, 
discussed previously), UltniChal will display any appropriate com¬ 
mand elements and then pause with a “press any key to continue” 
prompt before exiting back to TBBS. 

For some commands, such as a handle change, this is the desired 
effect. Some one-shot commands, however, arc best executed with 
an immediate return to TBBS without the pause, When you want 
this behavior use the /N switch in conjunction with the- ,'C: switch as 
follows: 

S DL menu example: 

Entry: <S>end a Message to Another User 
Key=S Type=203 Opt Data=/C:" /T‘ /N 


Customizing the Who’s Online Display 

One of Ultra Chat’s primary features is the who’s online display. 
Several such displays are available. In most types of who’s online 
displays, UltraChat will display a text string that identifies what a 
user is doing at any given moment. By default UUraChat assigns a 
fixed text description for each possible TBBS command type. 
However, you can dynamically override and customize the text 
shown to fully customize your “who’s online” display by using a 
special UUraChat Opt Data switch as follows: 

,T); < #>,<textl>,<text2> 

where the < # > portion of the switch designates a TBBS com¬ 
mand (Lhe Type « field in a TBBS menu entry) to execute. 

The <lcxtl> portion of the switch is the Opt Data string for this 
command. It must be in quotes if there are any embedded spaces. 

The < (e*t2> portion of the switch provides the text to show' iu 
replacement of the %RC01VIMAND% insertion parameter in 
who’s online displays as long as the user remains within the com¬ 
mand type provided by the < # > portion of lhe switch. It must be 
contained in quotes if there are embedded spaces. This text is 
limited to a maximum of 30 characters. 
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By executing UltraChat "with this switch instead oX executing a 
TBBS command directly, you can tuilor to as high a degree- as you 
want what is shown in the- UltraChat “who's online” displays. 

For example, if a menu entry looked like this: 

Entryi 

<E>nter The Wild Side! 

Type=203 

OptData=/D:200 # n Ft\TDBS\TWS /Q-^'Wild Sid©l" 

then UltraChat (represented by Type=2G3) would be executed. It, 
in turn, would set the <text2> string “Wild Side!” as the 
< &RCOMMXND% tract and then execute a TBBS Type 200 (the 
number given by the < # > portion of the switch), with an Dpt Data 
of “F:\TDBS\TWS /Q” (the <texll> portion of the switch). 

Here’s another example: 

Entryi 
<S>YSOM 

Type=203 opt Data=/D:205 # "" r "using SYSOM' 1 

This would cause UltraChat to set "Using SYSOM 7 ' as the 
c ^RCQMMAND% text, then execute a Type 205 (SYSOM, in this 
case) wilh blank Opt Data (since the <textl> string is empty). 

Note that UltraChat understands what a user is doing based only 
on the TBRS menu command type the user is executing. Once you 
set a string in conjunction with a particular command type number, 
that string will be displayed for that user every time they execute 
that command type until you override it again. For example, m the 
first case outlined above, “Wild Sid el” would be displayed for a 
Type 201) for that user until you override the text again using the 
same technique. 

IMPORTANT: If you want either the < lextl > or the < lext2> 
portion to be blank, you must use a pair of double quotes, like this 
-" - to designate an empty text string. 
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Sample Emulations _ 

UltraChat is supplied with four sample emulations: one each for 
Oracomm, Major BBS, DJ >X and TBBS. These closely emulate the 
chat facilities of these various BBS packages, and are designed to 
make the transition to UltraChat: (and/or TBBS) smoother for you 
and your users. They can continue to use and enjoy the same 
functions, invoked with Lhe same keystrokes they are familiar with, 
while within the UJtraChat environment. 

IMPORTANT NOTE: These sample emulations are for Ultra- 
Chat. Although they will help serve to make your overall BBS more 
familiar when converting from another BBS package to 
TBB S/Ultra Chat, their primary benefiLs will be available only 
within the chat environment. Outside of the chal environment, you 
will still need to design your system (using TBBS menu designs 
and/or changes to the TBBS language file) as you or your users 
desire, and if you wish, to pattern the system functions and 
keystrokes after the BBS software you are converting from. 

These emulations are provided us separate configuration files for 
Ultra Chat. Y ou cau use 3ny one or more of the emulations. Many 
TBBS sysops have decided to make all of them available to users 
simultaneously and allow' users to pick which one ihey like best. Or, 
if you wish, you could settle for one ufthe emulations and make 
additions and mndificarious to it as you see fit. "With UltraChat, as 
with TBBS, you are under complete control of the system and the 
services it provides. 

When you are converting from anuLher BBS product lo 
TRBS/UltraChat. in most cases, you’ll select the emulation that 
maLches the product you’re converting from. Initially, you may wish 
to simply run that emulation a$-is. oSoft has put a considerable 
amount of time intu making these emulations match the chat func¬ 
tions of the products emulated as much as technically possible. Ur 
you may wish to make changes to the emulation, or add functions 
that the product you converted from cannot offer. During beta 
testing of the UltraChat product, most sysops found their users 
enjoyed having additional, previously unavailable chat functions 
open to them. As you explore UltraChat, make notes of its 
capabilities that you may wish to add to your system. 


♦ 
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The emulations are packaged on the UltraChai disk in individual 
sub-directories. Within each sub-directory is a configuration file for 
the emulation, as well as a collection of help files that go with the 
emulation. 


CAUTION: In cases where you wish to use multiple 
emulations simultaneously, you will need to ensure 
that the names ol the various files for each emulation 
do not conflict with the file9 of another emulation. 


The directories and their emulations arc: 

\DLX Emulal es DLX chat facilities 

\ORACOMM Emulates Oracomm chat facilities 
\MAJOR Emulates Major BBS chat facilities 

\TBBS Emulates TBBS chat facilities 


Converting From Another BBS Package _ 

Many sysops are converting to TBBS/UllraChat from other BBS 
packages. They have found, as you might have, lb at TBBS allows 
them to offer chat facilities compatible with the BBS they have 
converted from, while giving them a platform which can support 
many additional functions (such as fully integrated FidoNet sup¬ 
port via TIMS, fully integrated Internet mail support via PIMP, 
online games and system utilities via TDBS, QWK offline reader 
support via QSO, and so on). 

However, converting from one BBS package to another can be a 
traumatic experience for users of your BBS. By definition, no BBS 
package is capable of emulating 100% another BBS package’s 
interface, keystrokes, capabilities, or functions. TBBS is the most 
configurable BBS product available anywhere, and this flexibility 
makes it a superior platform when converting from another pack¬ 
age. You must understand, however, that even a BBS as con¬ 
figurable and powerful as TBBS cannot be made to match yoar old 
system exactly. 
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During the development and testing of UltraChaL, eSofl worked 
with, dozens of entrepreneurial sysops who converted from other 
RBS packages to TBBS/UltraChat. From this experience, we 
learned that in most cases sysops did in facL experience initial 
shrinkage ii> user base, new user subscriptions, and income. But in 
all cases, the trend reversed itself after being on TBBS and Ultra- 
Chat for just u short rime. Virtually all the sysops who converted 
reported <i steady (and in some cases very dramatic) increase in 
user base, new subscriptions, and most importantly, income after 
the conversion was complete. 

Tli is did not go unnoticed by other sysops. In fact, we received a 
number uf comments from sysops who were not beta testing Ultra- 
Chat indicating that their business was being impacted by another 
system who was beta testing the product! 

This process can be alarming at first, hut it is an underslamiable 
dynamic. Most users enjoy your BUS for very intangible reasons, 
often being quite emotionally bonded to your system When you 
make a major change to “their baby, :i initial fear and disappoint¬ 
ment is inevitable. You may receive complaints - iu some cases lois 
of them - but do not allow yourself to get discouraged, Provided 
you execute a conversion plan carefully (whichwe'll discuss below), 
you'll be handsomely rewarded in time. 

If you arc converting from another BBS package, keep the following 
io mind: 

• Develop a eonversiua plan. This includes a timetable for the 
conversion from the old software, as well as a sort of “marketing 
plan" - how you’ll prepare your users for the change. 

• Allow enough time. When developing your plan, allow yourself 
plenty of time to learn TBBS and UltraChat before you put it 
online, 

• Do not convert before you understand. Make absolutely certain 
that you arc proficient with TBBS before you convert. If 
problems occur during ihc conversion you will then he equipped 
with enough knowledge to solve them. If you try to rush the 
coaversion, you very well might end up in a tiglu situation you 
cannot easily recover from, which will serve to annoy your users 
and impact your income as well, 
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• Build first, then convert. On a separate system, install and 
develop the ncwTBBS software. Get everything installed and 
working perfectly. Test the new system with various user classes. 
Test as a new user. Make absolutely certain that everything on 
the system from top to bottom is working properly. Many sysops 
who participated in the testing of UltiaChaf went so far as to 
have extra lines installed and put their new r TBBS online on a 
separate telephone number group before conversion. This 
allowed users to get familiar with the new- system before the old 
one went away, and provided the sysop with a real service by 
having the new system tested in a “real world" setting. 

• Handle users carefully, Before you make the change, notify ymir 
users in advance through online bulletins, mailed information, or 
whatever you feel is best, Let them know you’re making a change, 
and most importantly, tell them wiry. Be positive! Tell them all 
the good things they’re going to get from making this change. 
Outline everything new you’ll be adding: online games, 
networked mail (FidoNet, Internet), QWK offline reader 
support, and so on - anything that’s a new feature you can now 
provide and could not offer before. If users arc excited about the 
change, they’ll accept it much more readily. 

• Be prepared to help. Once the conversion is complete, be 
prepared to spend some long sysop hours helping people with 
the new system. There, arc bound to be questions, and depending 
on how much time you invested up front, there maybe a problem 
or two as well. Be patient with yourself and your users. Things 
will calm down and. return to normal in time, 

• Perform your conversion during the week (not the weekend), 
and during the limes of day that eSofL lechnical support staff is 
available. (At this wiiLing, our hours are Monday through Friday, 
from 10:00am to4:30pm Mountain Time, except major US 
holidays.) That way, if you do need the assistance of cSoft 
technical staff, you can reach us as the conversion is 
implemented. 



Chapter 2: Overview 


Why eSoft Created UltraChat _ 

UUraChtu. is one of the most ambitious product development 
projects that eSoft has ever underteken. Jt represents thousands of 
man-hours of effort in research, design, development, and testing, 
over the course of nearly a year and a half. Wc arc often asked why 
we decided to create UlLruChal and devote so many resources to 
the project. 

Historically, TBBS has been used in business and entrepreneurial 
settings where chat facilities arc either not an issue at all, or have 
been just a small part of the overall focus of the system, 7 n 1992, we 
began to nuLice a marked increase in the number of potential 
customers who were approaching us needing a UBS package wiih. 
superior chat facilities. Simultaneously, our current customers were 
asking for more and more in the way of a chat system lor TBBvS. We 
decided to embark on a research project to determine why there 
was such a change in the tide of demand for chat facilities. 

What we discovered were two primary reasons; lack of availability, 
and popularity. 

Sysops who were running Oracomm and DJLX bulkliuboards were 
Finding that they had too much success. These packages have a 
‘hard limit 7 ’ of 32 simultaneous phone lines, with no availability for 
expansion - but with increasing demand fur the System. We talked 
to entrepreneurial sysops who conveyed horror stories of endless 
busy signals and user complaints about them. These sysops were 
stuck with too much success and uo way to make the situation any 
better. 

Meanwhile, chat as a BBS function was increasing in popularity as 
more and more members of the general public became aware of 
bulletin boa ids and Lheir capabilities. Our own customers, who 
previously had been satisfied wiLh l'BBS 7 internal chut facilities, 
began to ask more and more often, “when is eSoft going to improve 
tbe chat facilities of TBBS M . 

To address these needs, eSoft studied what it would take for us to 
create and offer improved chat facilities. Initially, wc explored 
enhancing TBBS J own chat facilities. Rut oltr research had shown 
that truly good quality chat is not a xmall tiring- it has many unique 
requirements. Wc also knew that the best chat would have to be 
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totally configurable, following the TBBS model. As we outlined 
what we would need to do, it became clear that adding capabilities 
to TBBS itself would be a mistake, unnecessarily bloating and 
complicating the core pro dud, affecting everyone who used it. 

We also found thatwhile sysops were happy with thdr success, most 
felt their chat software could be improved. They were receptive to 
the idea of change if the software would do what they wanted. 

We thus decided to begin development of a chat option module 
designed specifically for those sysops who needed enhanced chat 
facilities. We used the results of our re-search to develop a feature 
list for what would become UltraChat, Since our research had told 
us that chat is a wry emotional, intangible thing for a BBS user, we 
decided that wc -would have to develop the product differently than 
we normally do. We would have to go much more slowly and 
deliberately than usual to ensure that UltraChat had the features 
sysops and users, demanded, while maintaining the emotional "feel” 
that would be critical to its success with BBS users. 

In the end, UltraChat look more than 17 months to develop. At 
every step of the way, we were paying very' dose attention to the 
reaction of sysops and BBS users alike. The design of UltraChat 
was changed and augmented many times during its development, 
reflecting what our continuing research showed us about chat. 

What you hold in your hands today is the most powerful, most 
elaborate chat system ever developed for use on a bulletin hoard 
system. With UltraChat, you can provide virtually any chat function 
you can imagine. 

Our research has not ended. At eSoft, we aic always looking for 
your feedback and comments about our products. If there arc 
functions you fed UltraChat needs, we want to bear from you. We 
will be incorporating your ideas and thoughts into an UltraChat 
upgrade, which will be provided free of charge to registered Ultra- 
Chat 1,0 sysops. To reach us, post a message on our eSoft Support 
BBS in the blew Features message aTca, or scud us mail to: 

New Features 

eSoft, Inc. 

15200 E. Girard Avc., Suite 3000 

Aurora, CO 80014 
USA 
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An UltraChat Orientation 


UltraChat is designed with a completely modular approach to 
configuration. This structure, unlike anything ever designed for 
chat systems, allows you complete control over the form and func¬ 
tion of yuur chut environment. If you wanted, you could have a user 
named JOHN DOE receive a totally or partially different con¬ 
figuration ifhe calls on line 3 between 10:00 and 2:00 on any Friday 
the 13th. Of course, in most cases, your configuration needs are 
more modest. UltraChat gives you the control you need and want 
- from the practical* to the bizarre, to the downright amusing - 
imagine a different configuration only on April Fool’s Day! 

The capabilities of UltraChat are expansive and powerful. With 
UllruChaLs modular structure, you can take advantage of any or all 
the features described below. 


General Features of UltraChat 


• Define up to 65,535 chat channels (conferences) per group, 
which can be conditioned on privilege level, access flags, line 
number, modem speed, active group, username, language 
selection, time, day, calendar date, and/or a special passed 
parameter. 

• Up to 25f] groups can be defined; a total of over 16 million 
distinct “places to be within chat” can be defined. 

• Any chill command or configuration item can be conditioned on 
privilege level, access flags, line number, modem speed, active 
group, user name, language selection, time, day, calendar dale 
and/or a special passed parameter. 

• All commands, command keystrokes, prompts, text displays, 
error messages, etc., are URJ 1 ^ configurable. Bach user or group 
of users may have a different combination if you wish. 

• Named ur numbered channels (conferences) may be used; the 
two types can be mixed within a single chat environment* 

• One private channel per user, and private 1-to-l chat, 

• Moan macros, also known ns “action words 57 io other ELSS 
packages. Allows completely customized “canned chat message 
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sequences'’ to be sent by users. For each macro, a text display 
can be sent to the user sending the macro, the user receiving it, 
or others in the public channel* each one can be conditioned on 
whether you direct the macro to a specific user and/or entered a 
1 ext string with the macro. 

• Full support for and enhancement of TBBS bitting class timing. 

• TDBS API allows smooth interaction between UltraChai and 
TDBS application programs. (UltraChat is supplied with a 
TDBS-based survey and matchmaking system.) 

• User can monitor a secondary channel; allows eavesdropping of 
a channel otbeT than the one you arc on. 

• Users can set a password for private channels, or otherwise 
control their channel by invitc/unhvile commands. 

• Who’s online displays that offer: 

• Ail users on your channel. 

• All users on any channel. 

• All users on Ihe system, whether in or out of the chat 

environment. 

• Three-line bio information for new users, individual 
users by name, alphabetical by user (forward or reverse), 

• Three-line bio auto-lookup of “From:” user from a 
TBBS message read prompt. 

• Full control over formatting of Ihe who’s online display 
for each type of who’s online command you provide; 
include or exclude information such as user name or TF>, 
locaLiou, conference channel name or number, 
threc-lioc bio, announce string, and much more. 

• Any who’s online display can show or suppress invisible 
users and/or idle lines. 

• Any who’s online display can be conditioned on 
privilege level, access dags, line number, modem speed, 
active group, user name, language- selection, time, day, 
calendar date and/or a special passed parameter. 
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• Exit back l o TBBS me mi, 

• Exit from private channel to public channel. 

• Perform Type 10 system logod. 

• Logoff without display (immediate carrier drop). 

• Chat exit can send logged off or dropped currier 
message to other users. 

• Chat exit can send left chut message to other users. 

• Chat exit can send left channel for another message to 
other users. 

• U1 iraCh at offers a variety' of ways to provide help online, 

• Niue (9) command definable, each with its own help file 
display. 

• Nineteen (19) commands definable with text string 
display to implement commands such as version, system 
name, currem date and tune, etc. 

• A user can scud a message to another user iu a variety' of ways: 

• Send specific message to specific user. 

• Send specific message to all users. (Like all UltraChat 
command, this may be set to be available ot not based 
on privilege level, aoccss flags, line number, modem 
speed, active group, user name, language selection, 
lime, duy and/or calendar date.) 

• Page user (sends canned message to specific user). 

• There are a number of ways to change chat channels or 

conferences within UltraChat: 

• Go to public channel by number, 

• Go to a public channel bv name. 

• Go to a user’s private channel (can be conditioned on 
invitation or password). 
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• Users can cbat privately with one another within the chat 
environment, Private chat options are: 

# Ask a user to chat and wait for his or her arrival. 

• Ask user to chat with user-entered message and 
continue where you arc until other user accepts; users 
placed in l'to-1 chat upon acceptance. 

• Ask user to chat with yes/nu invitation; users placed in 
1-to-l cbat upon acceptance (tunned message delivered 
on refusal), 

# Ask user to chat with yes/no invitation; users placed ia 
l-to-l chat upon acceptance (user-entered message 
delivered on refusal). 

♦ Chat demand (chat shanghai) allows a user to “yank” 
another user into Ulo-1 chat without regard to invitation 
or acceptance of same. 

♦ U seis m ay configure themselves to be chalt able (may be 
yanked), limited challuble (invitation type only), not chattable 
(all invitations refused), or time chattable (requests allowed only 
every “n” minutes). 

* UltraChat allows a user to customize his or her own chat 
preferences. Like all UltraChat commands, you can selectively 
make these available or unavailable lo your users. They include.: 

# Three-line bio, allowing user-entered profiles. 

• Chat availability (whether private chatting is desired or 
not), 

* Ignox ft/jemember for all or specific users (suppresses all 
chat traffic from user or users). 

» Iimtc/uninviLe for all or specific users (controls whether 
someone is able to enter youi private chat channel or 
nol). 

• Visible/invisiblc, controls whether others online can sec 
you in who’s online displays. 

• Message acceptance level (whether private messages 
are accepted; whether logon announcements arc 
desired). 
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• Aimoun.cc string, a vanity it cm optionally dis played in 
who’s online displays, 

• Name for private chat channel. 

• Password for private channel access control. 

• User-ciLslomized “handle” to override their normal 
login name or ID. 

• Color settings used within chat displays. 

• Moan macro cnabie/dis ab le. 

• Shortcut commands required/not required. 

♦ Ultr aChat also supports moderated conferences. The following 

features are available; as with all UUraChal features, you can 

control who has access to each one; 

• Create a new named conference and become the 
moderator. 

• Moderator can silence a user in the conference. 

• Moderator can force u user in the conference to be 
logged off . 

• Moderator can force a user to be suspended (marked 
deletedin the TRB$ useriog). 

• Moderator can pass moderator status to another user. 

• Moderator may resign, leuviug the coafere nee 
unniod crated. 

• Moderator may assign a password to a moderated 
conference. 
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UltraChat Customization 


UltraChat is supplied with several sample configurations to suit a 
wide range of applications. The sample configurations arc designed 
to emulate the chat facilities of various popular chat-oriented BBS 
systems, including DLX, Oracomm, and Major BBS. We have also 
supplied a sample configuration that emulates (with some enhan¬ 
cements) the TBBS internal chat facilities. These sample configura¬ 
tions are designed to be "plug and play" - in other words, you can 
drop UlLraChaL and one or more of the sample configurations into 
your system and be ready to run. 

Once you have gained some experience with UltraChat, you may 
wish to male modifications to the samples we supply and customize 
them as you see fit. Or, you may wish to create your very own chat 
system of your own unique design. UllraChal gives you dozens uf 
tools you can use in a variety of ways to achieve these results. 

Please note that UltraChat configuration takes a great deal of time 
and patience to understand fully. W r e encourage you to experiment 
with UltraChat configurations, making youi test configurations 
ava il able only to sysops or a srn all gre up of trusled users. This allows 
you to make changes and then test them to determine how and why 
things work the way they do. Once you have tested your changes 
thoroughly, you can make them available to all your users, 


An Introduction to UltraChat Customization 

Customizing UltraChat consists of changing options in the 
UCHAT.CTL configuration file. This configuration file contains 
the various commands which tell UltraChat what to do and how to 
behave for each user. 

There arc two basic types of configuration in UltraChat: statements 
and commands, Statements allow you to configure general things 
within UltraChat, like how many channels arc available within the 
chat environment. 

Commands, however, makeup the bulk of UltraChat configuration. 
In UltraChat, command configuration is composed of a simple 
relationship between the commands themselves and command 
elements. Commands are things people can do in UltraChat, such 
as exit back to the BBS or send a private message to someone online. 
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Commands generally consist of a keystroke or keystroke sequence 
that a user types in order to activate a particular' operation within 
the UitraChat chat environment. For example, the command 
“/WHO” might be configured to show a list of the users online at 
tbc moment. 

Command elements (or just elements for short) are the results or 
effects of a command, and include responses displayed to the 
screen, things sent to other users, prompts, and error messages. 

Some commands don’t have any elemeoLs associated with them. An 
example of such a command might be one to exit the chat facility 
immediately and return to the BBS. In this case the user might be 
put back into the BBS without any interim response or prompting 
of any kind. 

Elements come in four forms: responses, prompts, remote displays, 
and error message displays. 

Responses are text shown to the user when a command is issued. 
For example, if a user changes a chat channel, UitraChat may send 
a respon.se to acknowledge that the channel was changed and what 
the new channel is. 

Prompts request additional information from a user, For example, 
i[a user issues a command 10 change a chat channel, but forgets to 
designate the channel they want to go Ur, UitraChat may prompt 
the user to designate the channel number. 

Remote displays arc text shown to a user (or users) who is the target 
of u particular command. For example, if a user pages another user 
online, the remote display is sent to the user who is being paged. 

Error message displays, as the name suggests, are text shown to a 
user when they make a mistake in the formatlixlg or syntax of a 
command. 

In summary, UitraChat configuration involves designating com¬ 
mands and command elements. Commands involve a key nr key 
sequence that is used to activate the command within the chat 
environment. Command dements arc the results of a command, 
and include responses, prompts, remote displays, and error mes¬ 
sages. 
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How Commands and Elements Are Connected 

As mentioned previously, there is a simple relationship between a 
command and its command elements. But how is this relationship 
formed inside Ibe configuration file? How do you connect a com¬ 
mand to its elements? 

Commands and elements arc connected through the use of a 
simple, easy to understand naming convention. We'll explain this 
with an example: that of changing channels. You may wish to refer 
to the command reference chapter in this manual to follow’ along. 

Le t's take the case of the basic channel change command, CHAN- 
NEL#01_CMD. This is channel changing command number 1, 
designated by the “01* in the command name. These numbers 
identify variations on the command. For example, CHAN- 
NEL#02_CMD is also a channel changing command - butit is used 
to toggle back and forth between public and private chat channels. 
The command reference chapter lists and explains all the various 
commands available to you, organized by functionality. 

Back to the CHANNEL#01 CMD command, What about its 
command elements? What is shown lo the user, and how do wc 
associate or connect it to this command? 

The “01” portion of the command name conies into play here. For 
example, if we want to have text that’s displayed to a user after they 
execute the CHANNEL#01_CMD command, wc could use the 
command dement CHANNEL#01_CONFLRM. Note that this 
command element name also contains “Ol 5 ’ in its name. This is how 
a command and its elements are associated. 

The CHANNEL# 02 CONFIRM element is also a confirmation 
response, but il would go with the CHANNEL#Q2_CMD com¬ 
mand, since they're both “(12" (or the number 2 channel changing 
function), 

We know, therefore, that the following command dements would 
go with the CHANNEL#01_CMD command: 

• CHANNEL# Q1_CHANPMT 

• CHANNEL# 01_ENTR Y 

• CHANNEL# 01_EXTT 
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But that none of these command elements go with CHAX- 
NEL#Q1_CMD at all: 

• CHAN NEL#02 CHAIN FMT 

• aiANNET^ 04 _N'OTTNV 

• CHANNEL#06 PWPMT 

These command elements don't belong to the CHAN- 
NEL^nLCMD, because none, of them, have “01” in theit names, 
They are therefore associated with or connected to different chan¬ 
nel changing commands. 

The command reference chapter has a complete list of available 
command dements, organized in the same groups as the commands 
they go with. 

Yon should also take the lime to review lhe sample configuration 
files provided with UltraChat for practical, real-life examples of 
bow commands and commands elements are used in typical Ulti a- 
Chat configurations. 


A Palette of Functionality 

When you set out to customize UltraChat, you will be specifying 
commands and command elements for functions you want Ultra- 
Chat to have. You select the desired commands and elements from 
u wide variety of those which UltraChat is capable of providing. 
Like the TBBS menu command types you use inside TBBS menus 
UltraChat provides a palette of chat functionality you can pick from 
and mix in any way you sec fit. If you do not wish UltraChut to offer 
a particular feature, such as the ability for a user to become visible 
or invisible to other users, then simply omit the commands and 
functions related to that feature. 

Or, if you want the feature, but want It to behave differently than It 
does in one of the sample configurations provided with UltraChut, 
then you can add, delete, or modify the commands and dements 
associated with that command. 

Where UllraChat really shines, however, is that you can make 
available mixtures of configurations, where some features arc avail¬ 
able to some users, while oiher features are available only to certain 
other users. UltraChat configurations can change based on line. 
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user privileges and access flags, modem speed, which group (usual¬ 
ly top menu) is active, user name, language selection, day, date 
and/or special passed parameters. By using TUBS’ own access 
restrictions at the menu level, you can also make configurations 
change based on the lime of day or day of the week, 

If you wish, you can even offer multiple configurations to users and 
let them pick which they are most comfortable with- and still allow 
all the users to interact regardless of which configuration they 
choose, They each see things as they expert, even though other 
users may he using different emulations. 


Tutorial - Recreating TBBS Chat Using UltraChat _ 

To assist you in understanding how to configure UltraChat, we have 
created a brief tutorial. This tutorial is designed to guide, you 
through the initial steps of setting up UltraChat to operate like 
TABS’ internal chat facilities. TBBS 1 chat is relatively simple, and 
if you’ve been running TBBS for any lime, it’s likely a chat system 
you’re familiar with. 

This tutorial will not guide you through the entire process of 
recreating TBBS’ chat; rather, we’U cover the most important 
aspects, with the goal being to orient you to an approach to con¬ 
figuring UltraCh at; How it’s don e, what’s involved, how commands 
and command elements relate, and so on. 

eSoft has supplied a pre-made TBBS configuration for UltraChat, 
which can be found in the \TBBS directory on your UltraChat disk. 
You may wish to print this out so you can follow along during the 
tutorial. We do, however, encourage you to perform the steps b the 
tutorial yourself independent of the TBBS configuration we 
provided you. 


Creating the Configuration File 

UltraChat configuration takes place within a text file: 
UCHAT.CTL. Therefore, the very first step involved in creating a 
configuration is to use your text editor (or a word processor in 
non-document mode) to create an ASCII text fde by this name. 
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While in edit mode, you should go ahead and configure the "busies” 
of UllxaC'hal, such as your name, BBS name, command parsing 
style* and so on. Substituting the names you wish to use. add tbe 
following configuration statements to your newly created 
IJCHAT.CTL file: 

SYSTEM NAME TEXT "The Chat BBS" 

SYSTEM_ID_TEXT "CaATEBS" 

SYSOP NAMEJTEXT "John Doe" 

UCHAT_DIR C:\TBB3\UCHATTHP 

TBBS_PAF.SER 

M IN_C HANNEL_NDM 1 

MAX_CKANNEL_NUM 4C 
LIST ME_SWITCH 110 
KILLLTHEKCY "X 

The first three statements all define names for you or your system, 
und should be u part of all UltraChat configurations. 

The L'G lATDIR statement is also a part of all UltraChat con¬ 
figurations, and designates the directory where UltraChat will store 
temporary information files. 

The remaining statements are general coniig statements which 
setup the chat environment to be like- TBBS. TBBS PARSER tells 
UltraChat to accept Line numbers (instead of names) in chat com¬ 
mands. The MtN_ and MAXCHANNELNUM statements in 
this context pertain to CH emulation in TBBS* the only area in 
TBBS cbaL where channel numbers are used. In TBBS, thev ranee 
from 1 to 40. The LTSTMESWITCH sets it so that the user 
doesn’t see himself in who’s online displays (the TBBS way of doing 
it)* and the KTLU_UtNE_KFY is the keystroke used to abort input 
(Clrl-X in a TBBS chat section). 

To know which general configuration statements to use, you should 
peruse tbe “General Configuration Statements” section of the 
Command Reference Chapter. Read the descriptions, decide 
which apply to you, and place them at the top of your configuration 
file. The statements we used above are those that would periain to 
al’BBS emulation 
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Entering Chat 


In TBBS, when a user enters chat they arc entering a named, puhlic 
conference. The next step in configuring our emulation is to imple¬ 
ment this type of construct in UltraChat 

A review of the general configuration statements in the Command 
Reference reveals the DEF1NE_C0NF statement. Since this Is 
used to define mimed conferences* that’s what we’il use to create a 
conference for our TBBS emulation. Add this line to your con¬ 
figuration file: 

DEF INE_CONF 1 "Public Chat" 

The 1 is the public conference identifier, We picked 1, since this is 
the first named conference we'll create. Our name for the con¬ 
ference is ‘'Public Chat,” but you can use whatever you wish. 

Wcnccd to make sure that when we put UltraChat in a TBBS menu 
entry that the user enters this public channel. To do this, create a 
TBBS menu entry similar to this one: 

Entry: 

<E>nter Public Chat 

Key=E Type=203 Opt Data=/E:6,l 

The /E:6,# switch tells UltraChat to enter a named channel on 
entry. The 1 used with the switch says to enter the named con¬ 
ference 1, which is the identifier we used with c»ur DEFlNE_CONF 
statement just a moment ago. 

That's ail that’s needed to get users tu enter our named public 
conference, just as they would with TBBS. 


Providing a Way Out 

Now that wc’vc given users a way to get into our TBBS-likc chat 
section, we need to give them a way Lo get back out once they*re in. 
When you're configuring UltraChat fresh (as we are here), this 
should be the very first command you define, since you’ll need it for 
testing any other commands - unless you want to keep rebooting 
the PCI If you don't provide a co mman d to exit chat, you’ll get in 
and never be able to get back out again. 
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In TBBS, there are really two types of exiting: one exits back to 
TBBS from a public chat section, and the other exits from private 
chat back to public chat. They both use the same keystroke (which 
IJllraChat supports just line). 

If you peruse the Command Reference chapter, you'll sec exit 
commands that match these two needed exit styles: 
EXIT#01_€MD, whieh exits back to the BBS, and 
EXIT#I)!2_( !MD that exits from private to public chat, (There arc 
other exit styles too - but they wouldn’t apply l u a TBBS emulation.) 

Let's first add the public to BBS exit; 

EXIT|01_CMD " / Q " MODE=CDEHI PARTIAL EXACT 

Since this is the first command we’ve added, some explanation is in 
order. 

Each command begins with Lhe command, name, in this case 
EXIT#01_CMD, the command UltraGml provides to allow exit 
from chat back to the BBS. 

The next part of any command is the text which a user types to make 
it happen. In TBBS chat, ancxit isdoncwtththc/Q[UlT] command, 
so we’11 use just /U here since TBBS can. act on the command with 
as little as that. 

The MODE — section is a little tough to understand at first, but it’s 
very simple. The modes are a series of letters which designate where 
wiLhin the chat environment this command is active and allowed. 
The beginning of the Command Reference chapter of the manual 
lists the available modes and what they mean. The mode letters 
wc’vc used mean that this command is available anywhere except 
wiLhin private chat (since in private chat in TBBS, the /Q command 
docs not exit a user to the BBS). 

The PARTIAL keyword means that a partial match on the com¬ 
mand is allowed, and Lhis is important for TBBS emulation. The 
reason is that '0 is die core of the command, but TRBS chat would 
allow a user to type /Q, /QUIT, /QU, /QUI or even /OMO DEM 
and all would have the same effect, By using PARTIAL here, it tells 
UltraCliat to allow this leading, partial style of maLching. 
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The EXACT keyword means that parameters arc not allowed on 
the command. For example, /QUIT would he allowed, but /QUIT 
FOOBAR wouldn’t be allowed. EXACT means that only the com¬ 
mand can be entered - no parameters are acceptable, 

That’s it! Our first command is done. To test what we’ve done so 
far, from DOS, type: 

UCHAT COMPILE 

IMPORTANT: Make sure, you recompile every time you make a 
change to configuration. If you don’t, your changes will not take 
effect! 

This compiles the configuration information so TBBS can use it. 
Run TEBS, logon, and access UltraChat. When you enter chat, at 
this point, you won’t see anything. But you should be able to type 
/Q, press Enter, and exit back to the BBS. If you’ve followed Che 
tutorial exactly so far, this should work perfectly. 


Exiting From Private to Public Chat 

As mentioned in the previous section, TBBS uses the 10 command 
for another purpose too: to exit private chat and go to public chal. 
That means we have another exit command to define. 

The command that allows this type of exit is the EXIT#C2_CMD 
command. You can determine this by perusing the Command 
Reference chapter. So let’s add this command to our configuration: 

EXIT#02_CMD "/Q" M0DB=3 PARTIAL EXACT 

This is almost identical to the exit command wc configured in the 
previous seel ion. There are two differences, however. 

First is the command came. In this case, we use EXIT#02_CMD 
since it’s the command we're wanting to happen in this situation. 

Secondly, the MODE - section is different this time. As we men¬ 
tioned before, the MODE = controls where within the chat en¬ 
vironment that this command can be used. WeTe using MODE =B 
in this case, since it will limit the applicability' of this command to 
private chat only - which is the only place wc w’ant it to be active. 


2-16 







Chapter 2: Overview 


Again, the beginning of the Command Reference section of the 
manual explains the meaning of the various VfODE= letters. 

Thai’s ill 

Let’s summarize where we're at: 

• Wc have two /Q commands, both of which perform a 
type of exit. 

• One of the /Q commands exits from public. chal to the 
BBS. 

• One of the /Q commands exits from private chat to 
public chat. 

ahead and recompile the configuration (from DOS, type 
UCHAT COMPILE, as wc did before), but you won't be able lc> 
test the second type of exit since we haven’t given a way to enter 
private chat quite yet. That will come later on. 


Listing Who J s Online 

We’ re coming righ L along with ou r n cw ch at system. One of the most 
popular and necessary features of chat is (he whey's online display. 
Let’s add a way for our users In list who is online. 

Tn TRBS, if you study the who’s online displays it provides, you’ll 
find that it provides three versions: 

• Who's online, system-wide. This is the 
/WlHO],S[YSTEM] (or /W,S for short) command, and 
is available anywhere wiLhin TfiBS chat. 

• Who’s online in this cbal section. This is the AV[HO] 
com tn and, and it lists who is in the chat area with you. 

• Who's online in this chat section when nobody else is 
there. This is also die /W command, but when you. issue 
that command when nobody else is in the chat section 
with you, it changes behavior to a /W,S command 
automatically. 

Wc can emulate all three of these commands. Let’s begin with the 
last of the three, the / W command behavior when nobody is in chat 
with you; 
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WEO#01_CMD "/IT MODE=CH PARTIAL EXACT 
WHO#01_HEADER "No other callers in 

conference t %CHANNBL%^M A M 

+ Callers currently on system^M^ 1 ’ 

WHO# 0l_NORMAL "Line %RLINE:+02%: %R(JSER%; 
% RLOCATION % (%RCOMMAND%) a M" 


Ultr aChat lets you define several who’s online commands. We 
picked theWH0#01_CMD since it's the basic type of who’s online 
display, and this is the first one we’re creating. The MODE-CH 
means that this command is active only within public channels when 
nobody else is present. Refer to the description of the MODE- 
parameter in the Command Reference chapter. PARTIAL means 
partial matching is enabled, so /WHO is allowed too. And EXACT 
means no parameters arc allowed on the/W command. 

The command elements we used are piitterned after TBBS’ chat 
displays, 

Next, let’s add the /W,S command; 

>rHO#02CKD M /W" MODE=ABCDHI PARTIAL BLANK 
who# 02_HEADER "Callers currently on ays- 

WHO# 0 2 Jfl ORMAL =WHO # 0l_NOKMAL 

Thai’s it! In this case, we picked WH0#CI2_CMD since this U the 
second of the basic who commands we’re using. The MODE = here 
allows the command to be. active everywhere, PARTIAL allows 
partial matching. 

The BLANK parameter here means that a blank must follow the 
command. ‘ Blank” means a Wank (a space), a comma, (,) or a tab 
must be typed after the command itself. Since the command we’re 
emulating is /W,S, this means that the user must, at ihe minimum, 
type a comma liter the /W for Ultra Chat to know it matches this 
particular who’s online command, which makes the behavior 
TBBS like. 

NOTE; Notice how the WHO#G2_NORMAL command dement 
has “=* WHO#01_NORMAL” as its text. This is called command 
element sharing, and is a way to save time and UltraChat memory 
space by reusing previously defined command elements. Id this 
case, the command element WHQ#02_NORMAL will use the 
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same texL as WI10 #0 1_N0RMAL. This is designated using the 
equal sign ( =) followed immediately by the. command element text 
to share. IMPORTANT: ihe shared element must be already 
defined previously in the file t as would be the case here, in order la 
be shared. 

Lastly, lei’s add our who’s on the channel command: 

'WHO#07_CMD ’’/W" KODE«=B[>I PARTIAL EXACT 
WHO|D7_HEADER "Callers in conference: 

% CHANNEL 

WHO 1107 NORMAL =WHQ)f01 NORMAL 


There! The WHO #07 CMD is the command provided specifically 
to iist who is in the same channel as you (the user). The MODB= 
command limits this command to places where there are others 
with you so it has the desired effect in the desired places, 

Spend some tunc in the who’s online display section of the com¬ 
mand reference chapter to acquaint yourself with the commands 
and elements available to you. 

Letting Users Communicate Privately 

Another popular command you’ll probably want to implement is a 
way for users to send private messages to other users. InTBBS chat, 
this is the ;'S (send) command UltraChat allows you to configure 
several such commands. We’ll only need one, however, so go ahead 
and add that command now: 

PRIVATE*ClCMD M /S" HODE=BCDHI PARTIAL 

Our MODE= portion allows the command to be used anywhere 
within tbe chat environment, and PARTIAL allows partial match¬ 
ing to emulate TBBS chat operation. 

We used PRTVATK#01_CMD, but PRIVATE#C11 CMD 
through PRIVATE#oy_CMD are all the same (we could have 
picked any one of them). 

Wc will, at course, need a few command elements to make this 
command behave like we want. In flic section of the Command 
Reference chapter I hut discusses private message sending, vnull 
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find several command elements available to you. Peruse the ones 
available to fmd ibe ones you want to use. For TBBS emulation, 
we*]I use two of them. 

The first is a confirmation message shown to the user who issued 
the command. Go ahead and add this now, immediately following 
the command wc just put in: 

PRIVATE|01CONFIRM "Message gent to line 
%RLIN£%'\M" 

This is identical to the prompt normally displayed by TBBS chat 
when you send a private message. The %RLINE% insertion 
parameter is used here, because it refers to the remote users line 
number (the line of the user we just sent the private message to). 
Note the ~ M at the end - this is a carriage return. Remember that 
you must put these in explicitly whenever you want a carriage return 
to be displayed. 

Now that Ultr aChat is confirming our message sending, let's add a 
way for the remote user to see the message: 

PRIVATEH01REMOTE "*K(%KL2NE : + 0 2 %: %HUS ER%, 
pvt MHg) *MSG%'M" 

This would result in a display that might look something like this: 
(02:ALAN, Pvt Mag) Hollo therai 

Very TBBSTike! The text begins with a double carriage return, as 
docs TBBS when it displays an incoming private message. The 
%RLINE: + 02% insertion parameter gives the line number in a 
TBBS style. The %RUSER% refers to the user entering the com¬ 
mand, Finally, %MSG% shows the message the person who issued 
the command typed in. 

You’d also notice some punctuation and such to make the display 
look TBBS-like. 

That completes the private message send command, ft now allows 
a user to type in a send command just as they would in. TBBS. 

Compile the configuration, logon, and test at this point if you’d like. 
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Summary 

This is as far as we ll take you in this tutorial Alter completing it, 
you should have an understanding of the following: 

• The relalionsliip between commands and com mand elements. 

• Commands and. command elements are listed in the Command 
Reference chapter. You should peruse this chapter to learn 
about the capabilities of UltxaChul, and to make changes-to 
existing configurations or make new' ones. 

• The MODE = command parameter is used to indicate where 
and under what conditions within the chat environment that a 
command will be active. 

• The meaning of the PARTIAL, EXACT’ and BLANK keywords, 
('these are also explained in the Command Reference section of 
the manual.) 

• Command keystrokes can be duplicated} with the same 
command keystroke executing one command in some sections, 
and other commands in other sections. (The /W whirs online 
command we configured above is a perfect example of this 
concept.) 

• Command elements can be repeated by using command element 
sharing. (This also saves memory.) 

If you’re interesting in continuing with the TBBS chut emulation, 
you can refer to the sample configuration file supplied with Ultra- 
Chat. (You may notice some slight differences between the one 
supplied and the exercises in this tuLorial; the one supplied on disk 
is more verbose and complete.) 


Optimizing UltraChat Performance 


Internally, UltraChat is a very complex product. Under the hood 
where you and your users cannot see it, UltraChat is actually 
performing hundreds of operations, incorporating a significant 
amount ul processing. As such, there aro a number of ways you can 
optimize the performance of UltraChat. Here are some hints for 
optimization: 
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• The UCHAT DIR directory should be placed in a RAM disk 
drive, as it gets accessed frequently hy UltraChat. 


CAUTION: RAM disks can often conflict with TBBS 
memory segments. Use @ RAM disk only on a 386 (or 
greater) processor, and make certain that the RAM 
used by the RAM disk Is located In extended (also 
known as XMS) memory. DO NOT place the RAM disk 
In expanded (EMS) memory! 


IMPORTANT: The RAM disk drive must be referenced in vour 
TBB$PATH= statement in the RUNBBS.BAT file in order for 
TBBS and UltraChat to look for files there. Refer to your TBBS 
manual for details on setting the TBB-SPATH. For best perfor¬ 
mance, put the RAM disk first sequentially in the TBBSFATH = 
setting, before any other diredories. 

The UCHAT.SSJ and UCUATMONL$$$ files should be copied to 
the RAM disk (see above) and removed from the TBBS directory 
when yon start-up your system. This can be incorporated into ycrur 
RUNBBS.BAT file. Since, these files too arc accessed frequently, 
haring them in a RAM disk will improve performance. 


CAUTION: These two tiles are the compiled version of 
your UltraChat control files- If there are absent when 
you run the system, Ultra Chat will not function. Make 
sure you execute the UCHAT COMPILE command prior 
to copying them from the TBBS directory to the RAM 
diskdrive. Once they are copied to the RAM disk, delete 
them from the TBBS directory, since UHraChat will look 
there first before accessing the RAM disk. 


♦ UCHAT.CTL should be kept as small as realistically possible. 
Running more emulations, or running bigger emulations, causes 
the control file to be much larger. The larger it is, the longer it 
takes UltraChat to process the information in it, both during 
compilation and later online. 
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• Whenever possible, use the command element sharing technique 
discussed at the beginning (if the Command Reference section of 
the manual, This will save space in the internal tables of 
UltraC'hat, reducing memory and processing overhead, 

• As with TEBS itself, disk caching software - when carefully 
installed - can be ot“ great benefit to the system. Use a solid, 
reliable disk cache product. Make sure you disable any type of 
write caching, and make sure the cache memory is located in 
extended (XMS) memory and NOT in expanded (EMS) 
memory. Use a cache only on a38h (or greater) machine. 

Disable all advanced caching options available in your cache 
sofLware to reduce the possibility for conflicts and other 
problems that can arise from not using simple, basic caching 
options. 


BEST OPTION: Use a caching disk controller instead 
of resident software based disk cache. This eliminates 
the possibility of memory conflicts with TBBS. 
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£ UltraChat Configuration Reference _ 

This section contains a complete configuration reference for Ultra- 
^ Chat. Its purpose is to serve as a comprehensive resource when 

customizing UltraChat. 

J 
■i 
3 


IMPORTANT NOTE: Please refer to Ihe sample con¬ 
figurations supplied with UltraChat for examples of 
configuration usage. Specific examples of each state¬ 
ment, command, or command element are not 
provided in this reference, but rather, within the sample 
configuration files. 
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The Parts ot UltraChat Configuration 

Configuration verbs in UltraChat come in three forms: statements, 
commands, and command elements. 

Statements arc l or the benefit of UltraChat itself, and allow you to 
conLml bmad, sweeping functionality. For example, iberc is a 
configuration stateme-nt that allows you ro set how many channels 
axe available within tire chat environment, 

Commands arc for ihc benefit of people using UltraChat, and form 
the basis of most of the configuration, you do for UltraChat. Com¬ 
mands designate what functions are available to users while within 
ihe chuL environment. For example, there arc several different 
commands that allow yon to create who 7 & online displays. 

Finally, command elements relate to specific commands, and tailor 
what each command docs. Command elements always designate 
text that is shown to users us a result of a command. For example, 
a channel changing command might display confirmation text to a 
user. Command elements come in four types: responses (text shown 
to the user issuing a command), prompts (text shown to the user 
issuing the command asking for more information), remote displays 
(text shown to other users as the result of one user performing a 
command), and error messages (shown to a user issuing a command 
when they make a mistake). 




Chapter 3: Command Reference 


Command Formatting 

Since commands form the basis of most Ultra Chat configuration, 
it’s important to understand how command* are formatted when 
you configure them. Command verbs always hare the suffix _CMD, 
such as EXIT#02_CMD and WHO#07 CMD. All commands 
adhere to this format: 

<cmd type> <word> xoDE=<mode> [PARTIAL] 
[EXACT] [BLANK] 

For example: 

EX IT If 01 CMP EXIT MODE=BCD EXACT 


This defines a command string ‘‘EXIT” which when typed by a user 
will cause an EXIT#01_CMD type of command to be executed as 
long as EXIT is the only thing the user typed oft the line. The 
parameters arc as follows: 

< cmdtype > - one of the listed command types. 

< wnrd> - The “word" to match to cause execution of the com¬ 
mand, The word can be up to 14 characters, and can contain 
embedded spaces if the word is put in quotes. 

MODE= Cmodc > - The “modes” when the command is valid. 

< mode> can be any siring of the letters A through 1. The tetters 
MUST be together and MUST NOT be separated by spaces or any 
other characters. The allowable mode characters are: 

• A - called from a TBBS menu as a one-shot 

• B - valid within one-to-one style private chat 

• C - valid within mi mb ered public chat ch anncl when no one else 
is present 

• D - valid within numbered public chal channel when olliers are 
presenL 

• E - va lid when called from the TBBS read mes s age prompt 

• F - valid within a private channel when no one else is present 

• G - valid within a private channel when others are present 
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• H - valid withm a name d conference when no one c Isc is present 

• I - valid within a named conference when others are present 

There are also three keywords that can be used with each command 
definition: 

PARTIAL-When this command is matched, ignore the rest of the 
input up to a blank, tab, comma or end of input line. This can be 
used to make /W, /WHO, /WHAT, /WHOCARES all be acted 
upon as though only /W was typed, This is necessary for TUBS 
internal chat compatibility. 

EXACT - The user is not allowed to add any parameters to the 
command, or it will not be matched as being this command. This 
can be used in conjunction with PARTIAL to make n command 
that can match loosely, but can’t have parameters (the /QUIT 
command inTBBS Is an example of this). 

BI.AN K - The user MUST follow the command wiLli blank space. 
This can be a blank, tab or comma (comma is compatible with 
TUBS built-in that). This tan be used if one command is a subset 
of a moan macro word. 


IMPORTANT NOTE: COMMANDS ARE SEARCHED 
SEQUENTIALLY, SO MAKE SURE THAT IP TWO COM¬ 
MANDS START WITH THE SAME LETTERS, THE 
LONGER ONE IS LISTED FIRST. OTHERWISE THE 
SHORTER ONE WILL MATCH AND BE USED! 


Command Element Formatting 

Command dements always follow a command wirhin the LltraChat 
configuration. Command elements are linked to commands, by a 
shared prefix For example, a command element named INTER¬ 
ACTS ON is linked to Lhe command 1NT£RACT#02 CMD, 
because they share the same prefix: INTERACT#02, 

Command elements usually have a string of text as a parameter. 
Since this is the ease, except where noted, command cleracELs can 
be assumed Lo have the following format: 

< element> <tcxi> 
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Here’s an example of a command element configuration: 

action# 0l_CONFIRtt "— Generic action — 

In this example, “ACTION# OICONFIRM” is the command ele¬ 
ment, and the text that follow'?,, in quotation marks, is the text that 
goes with the element. 

Command element text can be handled a variety of waj'S. Refer to 
the section ‘Using Text in UltraChat Command Elements” for 
more details. 


Command Element Sharing 

Since command element text is often the same for multiple com¬ 
mands, you can save time, memory linage, and configuration Tile 
space by using command dement sharing. This technique allows 
you to specify command dement text once, then use the same text 
repeatedly in subsequently listed command elements. Here’s an 
example of this technique: 

CHANNEL#02 CKD JOIN MODE=CDFG EXACT ‘JOIN 

CHANNEL#02_CMD /J MODE=BCDFG EXACT j{J 

CHANNE L # 0 2 AN PMT "Who's private channel would 

you like to join? w 

CHANNEL#02 NOTINV "Sorry, but you'r« not invited 
to %RUSER:C%' s 

+ | private channel. “M 11 

CHANNEL#02 ENTRY M %RNSERrC% has just arrived 
from another 

+ | channel.'‘‘M" 

CHANNEL#02_EXIT "%RUSER:C% has just gone to 

another channel. A M" 

CHANNEL#03_CMD JOIN MODE-CDFG fJOIN <who> 

CHANNEL#03_CMB /J MODE=BCDFG BLANK j/j <who> 

CHANN El¥03__C HANPHT ~C HANNE L # 0 2 J2HAN PMT 
CHANH EL#03~"hOTINV -CHANNE L # C 2 _NOT INV 
C HANNEL # 0 3~ENTRY =C H ANNEL f 0 2_ENTRY 

CHANNEL!03 EXIT =CHANNEL#02 EXIT 
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maud elemenls here are CHANNEL#02_CHANPMT, 
... NOTINV, ... ENTRY, and ... EXIT.) Then, the command 

elements of the CHANNEL#03_CMD command share the pre¬ 
viously defined elements by using an equal sign (=) followed by the 
element to share, such as: 

C EANNEL |f 0 3 _ENT RY =CHAH NEL# 0 2 JEN TRY 

What this means k that the CHANNEL#I"I3_ENTR Y element is 
to have text identical to the CHANNHL#OZ_ENTRY element. 

The most important reason to use comm and element sharing is 
memory efficiency. UltraChat has a limited amount of space for 
cor figuration information. Each time you uniquely configure a 
command element, the text of the element consumes more memory. 
When you use command clement sharing, however, two (or more) 
elements can use the same text, which consumes memory once only. 
Use command element sharing whenever you don’t require 
separate text for multiple, similar command elenienLs. 


IMPORTANT: WHEN USING COMMAND ELEMENT 
SHARING, THE SHARED TEXT MUST BE DEFINED 
EARLIER IN THE CONFIGURATION FILE - YOU CAN¬ 
NOT SHARE AN ELEMENT WHICH IS NOT PRE¬ 
VIOUSLY DEF1N EDI 


General Configuration Statements 


The general, over a] l configuration of UllruChal behavior is done 
with a variety of items called general configuration statements. 
Thcse statements allow you to control a variety of items, such as the 
directory UltraChat uses, how many channels are available, the 
length of the inactivity timeout, and much more. 


UCHAT DIR <directory> 

UltraChat temp directory. This statement allows you to designate 
the drive and path of UltraChat temporary directory. To optimize 
the use of memory, UltraChat often temporarily stores information 
(such as the private message queue) to disk. This directory is used 
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for that storage. Using a "RAM disk for this directory will help 
increase overall UltraChat performance. Refer to the “Optimizing 
Ultra Chat Performance” section. 


INCLUDE < filename > 

This statement allows you to designate the name of other files that 
contain UlLraChat configuration information, and tells UltraChat 
lo bring the configuration information in those files into effect. If 
there are multiple configuration files you wish to include, you must 
use a separate INCLUDE statement for each one. You may nest 
INCLUDE statements (INCLUDE statements within an 
TNCLUDEd file) up to five (5) levels deep, 


NEW_USERS NUM < number > 

Designate the last < number > users as new. This statement allows 
you designate how many users get displayed when an UltraChat 
user docs a WHO#06_CMD command (discussed later), which 
allows a listing of "new'” users. By setting a value in this statement, 
you're telling UltraChat to show the lust < number > users in the 
TBBS user log file that arc not marked invisible or deleted when a 
user issues the WHO#06_CMD command. The UltraChat default 
is 10 users. 


ANNOUNCE CHARS NUM < number> 

Size of announce string. This statement allows you to define how 
many characters maximum arc allowed in an “announce” string. 
The default is 30, the maximum allowed value is 80. Refer to the 
glossary for on explanation of announce strings. Announce strings 
are set by a user with the EDIT#01_CMD command, and arc 
displayed online with the %ANNOUNCE% and %RAN* 
NOUNCE% insertion parameters. 


MIN CHANNEL NUM < number > 

Set lowest allowed channel number. This statement allows you lo 
configure the lowest channel number allowed in the chat environ¬ 
ment. The default is 1, which is the same as Oracomm, (Major BBS, 
for example, has a minimum channel number of 0.) The minimum 
acceptable value is 0. 
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MAX CHANNEL_NUM < number > 

Sot highest allowed channel number. This statement allows you to 
configure the highest channel number allowed in the chat environ- 
meat. The default is 9 , which is the same as Oracomm. (Major BBS, 
for example, uses 65535,) The. maximum acceptable value is 65535. 

PUB CHANNEL NUM < number > 

Set highest allowed public channel number. This statement allows 
you to configure the highest channel number allowed within public 
chat. The default is that all channels are public. If Lhis number is 
lower than that set with the MAX_CIIANNEL_NUM statement, 
then all higher numbered channels allow anyone into them, but do 
not list the channel number on. who’s online displays. This effective¬ 
ly makes users in those channel “hard to find.” 

DEFINE CQNF <number> <name> 

Define a named confercnue. This statement allows you to define a 
named chat conference. ITie- <number > parameter designal.es a 
numeric conference identifier. IMPORTANT: These numbers are 
not the same as chat channels! The < name > parameter is a string 
of not more than 3G characters of text, If embedded spaces arc 
desired, place the name within quotation marks. 

LAST LINE NUM < number> 

Set highest line used on who’s online displays and for lookups. This 
statement allows you to configure the highesL TBBS line number 
that UhraChat will look at when looking up users and doing who’s 
online displays, etc. This is useful if you have some ghost lines that 
you don’t want to have counted. 'The maximum number is Lhe 
number of lines your TUBS is configured to suppuui. Who’s online 
display commands, WFTO#xx_CMD, use this to limit their scope. 
This also limits the lines looked at to find users that are Largets of 
commands. 
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PUBLIC ENTRY KEY <key> 


Set the key which allows entry to chat when entering in Oracomm 
mode. This statement allows you to configure the keystroke that a 
user must press to enter public chai when they enter UltraChat in 
Orucornm mode. (The entry mode is designated with the /E: Opt 
Data switch.) The <key> parameter designates the key. The 
default key is C. 


PUBLIC EXIT KEY < key > 

Set the key which allows exit from Oracomm style chat. This 
statement allows you to configure the keystroke that a user must 
press to exit public chat when they are operating in Oraconun 
mode, (The operating mode is designated with the fEi Opt Data 
switch.) The < key > parameter designates the key. The default key 
is X. 


STOP,KEY <key> 

Set the key required lo stop scrolling display. This statement allows 
you to designate the key Lhat a user must press to stop a scrolling 
display where applicable. The default key is S. 


PAUSE KEY < key > 

Set the key required to pause scrolling display. This statement 
allows you to designate the key that a user must press to pause a 
scrolling display where applicable. The default key is P. 


YES KEY <key> 

Set the key required to answer YES to ves/no prompts. This state¬ 
ment allows you to designate the key that a user must press to 
answer yes to a yes/no style prompt within the chat environment. 
The default key is Y. 


NO KEY < Key > 

Set the key required to answer NO to yes/no prompts. This state¬ 
ment allows you to designate the key that a user must press to 
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answer no to a yes/no style prompt within the chat environment. 
The default key is N. 


TBBS PARSER 

Perform TBBS-style command parsing. This statement, when 
present, tells UltraChat to do command input parsing in a fashion 
like TBBS' internal chat. This means that commands that ordinarily 
accept a user name or ID will instead be looking for TBBS line 
numbers, like the TBBS internal chut system does. 


NAME_NUM_ PARSER 

Perform mixed style command parsing. This statement, when 
present, tells UltraChat to do mixed style command input parsing. 
With this sLaterne-nt active, when UltraChat accepts a command 
from a user, it will first attempt to match user-directed commands 
by a name or user ID. If no match is found, it will attempt to use the 
supplied “mure 1 ' as a TBBS line number, like the TBBS Internal 
dial system does. This stalemenL is esperiaUy useful in situations 
where you are converting from a TBBS internal chat system, and 
wish to make the transition easier for users familiar with TBBS chat 
and iLs line number oriented command convention. 


SHORTCUT KEY <char> 

Designate key used lo preface shortcut commands. This statement 
sets the single character designated by the <char> parameter as 
the shortcut key Far commands, When in shortcut only mode (dis* 
cussed later), and UltraChat receives a command from the user that 
begins with this character, it will attempt to match the input against 
a shortcut command, If no mulch is found, the input is treated as a 
public chat message. W'hcn UltraChat is noi in shortcut only mode, 
and UltraChat receives a command from the user that begins with 
this character, it will attempt to march the input against a shortcut 
command. But if no match 5s found, an error message is generated. 

The TOC»CiLE#04_CMD 1 ON*04_CMD, and OFF#D4_CMD 
commands control whether a user is in shortcut only mode or not. 
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NOTE: While in one-to-one private chat, lines starling with this 
ley are not sent to the user being chatted with, bur rather, the line 
is treated as a command when the Enter key is pressed. 


KILL LINE KEY < char > 

Designate line input kill (abort] key. This statement allows you to 
set a single keystroke thaL will abort or kill a user’s command input 
midstream. When a user in chat is midway through typing an 
UltraChat command, and they keystroke is issued by a user, their 
pending command is discarded by UlLraChal and the text given in 
the MSC#09JTEXT configuration statement is printed to the 
user's screen (to notify them that their input was discarded, the 
command aborted, etc ). 


OVERALL TIMER < minutes > 

Set overall chat lime limit, This statement allows you to set an 
overall chat timer in minutes, thereby controlling how long a user 
can stay inside the chat environment at one- sitting. Note that this 
docs not time by login or session, but rather, it times from the 
moment the user enters chat (jniblic or private). The user is given 
one minute and two minute warnings when this timer is about to 
expire as well as another warning when they are removed from 
Ultra Chat; the warnings are configured using thoMSC#12_TEXT, 
MSC#13_TEXT, and MSC#14_TEXT configuration statements. 
The default is no limit. 


INACTIVITY TIMER < minutes > 

Set inactivity timeout for chat. This statement allows you to set an 
inactivity timeout for use within the chat environment in minutes. 
If a user is in chat for the designated number of minutes and does 
not type anything, they will be logged off the system. This is inde¬ 
pendent of the TBBS master inactivity timeout (which does not 
apply when a user is with in the chat environment). The user is given 
two minute and one minute warnings when the timeout is about to 
expire, as well as another warning when they are logged off the 
system; the warnings are configured using the MSC#L5_TEXT, 
hfSC# 1/iTEXT and MSC#17_TEST configuration statements. 
The default is to allow' a user to stay inactive until their OVER- 
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ALLTIMER.TBBS billing class timer, or overall TBBS login time 
lirtiil expires. 

ENTER STRING <text> 

Set carriage return text substitution. This statement allows you to 
designate a text string that Ls sen! by UltraChat whenever a user in 
chat presses carriage remm (Enter) only without any other text. 
When this occurs the siring designated by the < tcxt> parameter 
is sent. If n command matches <text>, that command will be 
executed instead. HINT; If you want to have a command associated 
with Ihe carriage return key (which is the case with Major BBS 
emulation), then begin the <text> parameter with the 
KILL LINE KEY character since that will make a command a 
user cannot enter any other way. See the Major BBS emulation 
configuration file for an example ol this technique. 


HOT KEYS < mode > 

Set private message queue printing mode. This statement allows 
you to define how UltiaGhat should do printing of the private 
message queue when the system.has messages waiting (queued) for 
a user, (Private messages can queue up when a user is noL within a 
window of opportunity wheo a private message is received.) The 
<; mode > parameter can be one of the following; 

FLUSH. This flushes all lypeahead hot-keys when the prompt for 
“press anykey 1 ’ Ls displayed. 

NQJDISPLAY This makes the private queue not display when 
there Ls typeahead in the inpul buffer. B hot-keys arc pressed while 
the private message queue is being displayed, they are discarded. 

Note that the term “typeahead’* refers to keystrokes made by a user 
that have not yet been cxecutcdby TUBS, i.e., key’s that are pending 
or typed ahead, hence Lbe term typeahead- 
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MATCH ONUNE_FLAG <a_flags> 

Establish uscr-to-uscr matching for chat and who's online displays. 
This statement allows you to configure a system of access flag 
matching for users to be able to interact within the chat environ¬ 
ment. If you establish this matching, and users do nut match one 
another, then they will not see each other in the chat environment, 
and will nut be able to interact with one another. In mach the same 
way as TBBS menus, the matching is based on an access flag 
“mask/' There arc, however, six characters allowed instead of the 
usual three. The - (dash),. (period), and X (letter X) characters all 
mean the same as they do in menus, except now they mean the 
OTHER user has to have those flags set. The additional characters 
available arc: 

M means this flag for the OTHER user must match ME EXACT¬ 
LY. 

O means ANY ONE of the flags designated by “O” in Lhc respective 
access flag group (A1, A2, AS or A4) for the OTHER user must 
match ME. 

A means ANY ONE of the flags designate d by “A”for the- OTHER 
user must match ME, but all 32 access flags are taken into con¬ 
sideration (i.e., it spans AL, A2, A3 and A4 flag groups). 

For example: 

MATC1 i_0NLINE_FLAG A1 = AXMMMOO. A2 = A. 

A3=A-A4-A. 


In this example, the other user must have Al[2] = X and Al|8| 
or we don’t go any further. The other user must also match my 
Al|3], AIM, and At [5] EXACTLY. The Other user must also have 
the same Al[6] -OR- At [7] as me. Lastly, the other user must have 
one of A1[1J, A2\l] t A3[l] -OR- A4[l] set the same as me. 


MATCH USERLOG FLAG <a 11ags> 

Establish user-lo-user matching for uscrlog lookup related func¬ 
tions. This operates identically to the MATCH ONLENE F LAG 
statement, except That it covers uscrlog lookups such as arc done in 
various who’s online commands, three-line bio lookups, and so on; 
performed by a user with the WHO#xx CMD commands. 
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LIST ME SWITCH ON | OFF 

Designate whether the user’s own line is listed in who’s online 
displays. If the ON parameter is used, then the user’s line is in¬ 
cluded in such displays. If the OFF parameter is use<j ; then his own 
line is not included. The default is OFF. 


LIST PRIVATE SWITCH ON | OFF 

Designate how private chat is designated in who’s online displays. 
If the ON parameter is used, then all users in private chat will have 
their channels listed as w PRI:n” where "n” is the person they arc in 
chat with. If the OFF parameter is used, those users will show jusL 
‘^PRIVATE” instead of who they are in chat with. The default is 
ON. 


LIST INVISIBLE SWITCH ON f OFF 

Desi gnate wbethc r invisible u scrs are listed i n who’s on li ne disp lays. 
If the ON parameter is used, then users who arc marked invisible 
will be listed in who’s online displays using the appropriate com¬ 
mand elements. If the OFF parameter is used, then users who are 
invisible will not be shown in who’s online displays and will not be 
included m totals. The default is ON. 


READONLY SWITCH ON | OFF 

Designate whether user is in read only mode in public areas. If the 
ON parameter is used, then the user is in read only mode whenever 
in a public chaL channel nr conference, and cannot enter any 
message traffic into the conference. If the OFF parameter is used, 
then the user can interact in public areas normally. The default Is 
OFF. NOTE: You will most likely want to use this statement in a 
RESTRICT block to limit its applicability to the desired grouping 
or class of users. 
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Text Configuration Statements 


The following configuration statements, like the ones in the pre¬ 
vious section, arc general in their nature, but all allow you to 
configure text that is used in various places within the chat environ¬ 
ment. 


SYSTEM NAME TEXT <1ext> 

This statement allows you to configure the name of your BBS 
system, and is displayed by the %SYSTEM% insertion parameter 
in online displays. 


SYSTEM !D TEXT <ld> 

This statement allows you to configure an ID of S characters or less, 
a short version of the name. This is displayed by the %$YS- 
TEMID% insertion parameter, and is a Iso used internally by Ultra- 
Chat to define your system name. 


SYSQP NAME TEXT <name> 

This statement allows you to configure the name of the sysop 
(usually your user name online). It is displayed by the %SYSDF% 
insertion parameter in online, displays. 


WAITING TEXT <string > 

Set text displayed for %WA1T1NG% insertion parameter. This text 
is used in conjunction with the %'WA1T1NG% insertion parameter, 
which can be used to show a user when they have messages waiting 
inTBBS. See also the %WAITINC 1 & insertion parameter for full 
details. 


IS TEXT < string > 

Set text for“is” portion of %IS/ARE% insertion parameter display. 
This statement allows you to set the text used when the %1S/ARE% 
insertion parameter shows the word “is” (or whatever you set) to a 
user. See also the “^TS/ARE^ insertion parameter for full details. 
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ARE TEXT < string > 

Set text for “are" portion of %IS/ARE% insertion parameter 
display. This statement allows you to set the text used when I he 
%IS/A R E% insertion parameter show's the word “are" (or 
whatever you set) to a user- Sec also the %IS/ARE% insertion 
parameter for full details. 


UNLIMITED TEXT < String > 

Set text shown by %TIMELEFT% when, a user has unlimited time. 
This statement allows you to set the text verbiage shown by the 
%TIMELEFT % insertion parameter when a user has unlimited 
time left. Sec also the %TIMEL£FT% insertion parameter for full 
details. 


IGNORED TEXT <string> 

Set text shown by the %IGNORED% insert ion parameter. This 
statement allows you to set the text verbiage shown by the %l<>- 
NQKED% insertion parameter is the user being referred to is 
being ignored. This is primarily used for who's online displays. It 
does not show whether the user issuing the command is being 
ignored, but rather. it is from the perspective of the pe^on that 
issued the command. Sec also the %IGNORED% insertion 
parameter for details. 


INVITED TEXT < string > 

Set text shown by the %1NV1T£D% insertion parameter. This 
statement allows you to scr the text verbiage shown by the %IN- 
V1TED% insertion parameter is Lhe user being referred to has 
been invited. This is primarily used for who’s online displays. It does 
not show’whether the user issuing the command has been invited, 
but rather, it is from the perspective of the person that issued the 
command. Sec also the ^ INVITED % insertion parameter for 
details. 
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User Related Text Configuration Statements 


The following statements allow you to configure certain user-re¬ 
lated text strings: 


USER#01 TEXT <text> 

Set string printed by %Y\-AGS%/%RYLAOS% when TBBS (F) 
flag is set This text is displayed as all or part of the expansion of 
the %FLAG.S% or %RFLA(»S% insertion parameter, when the 
affected user has their (F) user log flag set in ULEDIT. Normally 
used as part of who's online commands for customized status 
displays. 


USER#02 TEXT <text> 

Set string printed by %FLAG$%/%RFLAOS% when TBBS (R) 
flag is set, This text is displayed as all or part of the expansion of 
the %FLAGS% or %RFLAGS% insertion parameter, when, the 
affected user has their (R) ustiriog flag act in ULEDIT. Normally 
used as part of who's online commands for customized status 
displays. 


USER#03_TEXT <Tex!> 

Set string printed by %FLAGS%/%RFLAGS% when TBBS (K) 
flag is set. This text is displayed as all or part of the expansion of 
the %FLAGS% or %RFLAGS% Insertion parameter, when the 
affected user has their (JC) userlog flag set in ULEDIT. Normally 
used as part of who’s online commands for customized status 
displays. 


USER#04_ TEXT <text> 

Set %RAN NOUN CE % string. This statement allows you to set tbc 
text displayed by Lhc %R ANNO I JNCE.% string when the affected 
user is currently’ in "no chat” mode. This can then be used with 
who’s online display to alert others that the user in question is not 
currcntlv available for chut. 

m 
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General Chat Text Configuration Statements _ 

The following configuration statement allow you to define various 
text strings used in a variety of areas of the chat environment: 


CHAT#01 TEXT < text > 

Public message format. This statement lets you define the visual 
appearance of public chat message if you want something other 
than the default, which is to display the message as-is without 
formatting. ft allows you to define prefix information, etc. 


CHAT#02 TEXT <text> 

People waiting to chat, line-by-line display. Applies only when a 
user enters chat in Oracomm mode (/E:l Opt Data switch). This 
text string is printed once for each user (TBBS line) that is waiting 
to chat with a person when they enter the chat environment. See 
also CHAT #03 TEXT, below. 


CHAT#03 TEXT <text> 

Header shown on entry to chat when people are waiting to chat. 
Applies only when a User enters chat in Oracomm mode (/E:l Opt 
Data switch). This text serves as a header for the 
CHAT#02_TEXT displays (mentioned previously). Upon entry' to 
chat, this text is shown to the user if there are other users waiting 
to chat. This display is then followed by one ur more 
CHAT#02_TEXT displays (see above) to form a coherent display. 


CHAT#04 TEXT <text> 

Prompt whether to chat with a user who is waiting. Applies only 
when a user enters chat in Oracomm mode (VE:1 Opt Data switch). 
This prompt text is shown to a user when une olher user is waiting 
to chat wiLli them when they enter the chat environment. After the 
user is listed (with the CHAT#ft2 TEXT and CJIAT#03_TEXT, 
discussed above), this prompt line is displayed. It serves to ask the 
user whether he wants to chat with the one single user who is waiting 
to chat. 
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CHAT#05 TEXT <text> 

Prompt whether to chat with one of the users who is wailing. 
Applies only when a user enter 5 chat in Oracommmode (/E:l Opt 
Data switch). This prompt text is shown to a user when more than 
one user is waiting to chat with them when they enter the chat 
environment. After the users arc listed (with the 
CHAT#02_TEXT and CHAT#03_TEXT, discussed above), this 
prompt line is displayed. It serves to ask the user whether he wants 
to chat with one of the users who is waiting to chat. 

CHAT#06 TEXT <text> 

Header shown on entry to chat when people arc waiting to chat. 
Applies only when a user enters chat in Oraconun mode (/Eel Opt 
Data switch), This text serves the same purpose as the 
CHAT#03_TJ£XT display (mentioned previously), in that it is 
displayed when the user enters the chat environment. However, this 
is the text displayed when nobody is waiting la chat with the user, 
whereas CHAT#03_TEXT is displayed when there are users wait¬ 
ing to chat. 

CHAT#07 TEXT < text > 

Prompt user whether to wait for another user to come to chat. 
Applies only when a user enters chat in “wait mode" (either the 
/E:l switch, or from a CHAT^01_CMD command). Various chat 
functions executed from this chat entry method may prompt a user 
whether they wish to wait for another user to come to chat. This is 
the text shown to prompt the user to make this choice. When they 
answer yes, they will be placed into a wait mode for the other user 
to come to chat; if they answer no, the command will be aborted. 
This prompt asks the user which behavior they want. 

CHAT#08_TEXT <text> 

Waiting for chat to begin message. Applies only when a user enters 
chat in “wail mode" (either the /E:l switch, or from a 
CHAT#01_CMD command). Related to the CHAT#07_TEXT 
discussed above, this text is shown to the user when they choose to 
Wait lor another user to come to chat. 
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CHAT#09 TEXT <text> 

Tells of the Other user leaving private chat. This is related to the 
CHAT#07 TEXT, CHAT#U8 TEXT and their related com¬ 
mands. Once a user decides to wait on another user, and the other 
user dees come to chat, this message is displayed when the other 
user leaves when the private chat is completed. 


CHAT#10 TEXT <text> 

Tells of the other user entering private chat. This is related to the 
CHAT #07_TEXT, CHAT#08_TEXT, CHAT#09_TFXT and 
their related commands. Once a user decides to wail on another 
user, this text is displayed when the user they are waiting on comes 
into the chaL environment, alerting the waiting user that chat can 
now begin, 


CHAT#11 TEXT <text> 

Now in public chat alert. Applies only when a user enters chat in 
OracoruiTi mode (/E:l Opt E>ata switch). This text is shown Lo the 
user when they choose to enter public- chat from this type of 
UltraChat entry. 


CHAT#12 TEXT <text> 

Prompt for use in private nue-on-rme chat. This prompt is displayed 
when UlirnChm is wailing for input from a user while Lhat user is 
in private chat with another user. If this text is not used, then nothing 
is displayed as a prompt in private chat, 


CHAT#13_TEXT <text> 

Prompt for use in public chat. This prompt is displayed when 
UltraChat is waiting for input from a user while that user is in public 
chat with another user. If this text is not used, then nothing is 
displayed as a prompt in public diat. 
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CHAT#! 4 TEXT <text> 

User joining channel display. This text is shown u> other users on a 
chat channel when another user enters the channel from someplace 
other than another chat channel. 


CHAT#15 TEXT <text> 

User exiting channel display. This text is shown to other users on a 
chat channel when another user exits the channel, bound for some- 
place other than another chat channel. 


CHAT#15 TEXT <text> 

Acknowledge public message - recipient available. This text is 
shown to a user when he- enters a message- in a public chat channel, 
and there arc other users there who can see the message he typed 
in. 


CHAT#!7 TEXT <text> 

Acknowledge public message - recipient not available. This text is 
shown to a user when he enters a message in a public chat channel, 
and there are no other users there to see the message that was typed. 
Ordinarily, this text is used to alert the the user that his chat message 
went to nobody. 


CHAT#18 T EXT <text> 

Acknowledge exit from private channel. This text is shown to a user 
when he exits a private chat with another user, to acknowledge that 
the exit took place. 


CHAT#19 _TEXT <text> 

User hang up alert. This text is shown to other users in a chat 
channel when a user hangup in chat. Usually used Tot "user 
vanished” displays and such. 
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CHAT#20 TEXT <text> 


Private channel prompt, Related to CHAT#12_TEXT and 
CHAT# 13 TEXT, this text is shown to a user when they arc in a 
private chat channel as the input prompt. When this is not used, 
Lhere is no prompt when in a private channel. 

CHAT#21 TEXT < text > 

Chat prompt used on high channel numbers. Related to 
Cl I AT #32_TEXT, CHAT# 13TEXT and CHAT # 20 JTEXT, 
this is the prompt shown to a user when they are in a chat channel 
numbered higher than the number set with the PUB CHAN- 
NFL NTJM configuration statement. 


C HAT#22 T EXT <text> 

Chat prompt used on lowest channel. Related to 
CHAT# 12__TEXT, CHAT#13JTEXT, CHAT#20 TEXT, and 
CHAT#21_TCXT, this is the prompt shown to a user when they 
arc in a chat channel equal to the one set with the MIX CHAN- 
NELNUM configuration statement, 


CHAT#23 TEXT <1ext> 

Preface for buffered mode chat message displays. This text is shown 
to preface incoming chat messages whenever chaL messages arc 
buffered. (Messages are buffered within channels, but not within 
private one-on-one chat.) Generally, this is simplv a carriage return 

r*). 

CHAT#24 TEXT <text> 

User you're waiting on logged off message. Applies only when a 
user enters chat in “wait mode” (either the- /£;1 switch, or from a 
CHAT#01_CMD command). This text is show’ll to a user W'bo is 
wailing on another user, and that other user logs off the system prior 
to coming to chat. 
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General Error Text Configuration Statements 


ERROR#01 TEXT <text> 

Bad command input error. This text is displayed when a user enters 
a command within the chat environment that UltraChat cannot 
decipher. 


ERHOR#Q2 TEXT <text> 

User not online error. This text is displayed when a user executes 
a chat command which references a user who must be logged onto 
the system in order for the command to work, and ihe user refer¬ 
enced is not online. 


ER RO R#03 TEXT <text> 

User name or ED ambiguous enor. This text is displayed when a 
user executes a chat command which references a user name or ID, 
but the name or ID entered is not specific enough for UltraCbal to 
reference it to a user. This applies in some cases, since UltraChat 
does not require a user to enter a complete name or ID, only a 
partial match. In essence, this error means that a partial match was 
made with more than one user. 


ERRQR#04 TEXT <t9xt> 

Who command executed while user invisible error. This text is 
displayed when a user attempts to execute a who’s online display, 
but that user is marked as invisible. 


ERRQR#05_TEXT <text> 

Chat message sent to user in no chat mode error. This test is shown 
to a user who sends a private message (PRIVATE#xx_CMD) to 
another user, and that other user is currently in no chat mode. 
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ERROR#06 TEXT <text> 


Command on yourself error. This text is shown to a user who 
attempts to execute one of various commands which reference a 
specific user, and the user specified himself as the target user for 
the command. 


E R ROR #Q7_TEXT <text> 

User name or ID ambiguous, but one exact match error. This text 
is displayed when a user executes achat command which references 
a user name or ID, and the user name or TD given does match at 
least one user exactly but still may apply to more than one user. This 
applies in some cases, since UltraChat does not require a user to 
enter a complete name or ID, only a partial match. In essence, this 
error means that a partial match was made with more than one user. 
This text should tell the user to end the user name with a colon ( : 
) to designate “exact match with this user” Refer to the sample 
configurations supplied with UltraChat for specific applications. 


ERRQR#08 TEXT <text> 

Public message attempted when in read only mode error. This text 
is shown to a user who is in the public chat channel in read-only 
mode, and the user attempts to enter a public message (which is 
prohibited from read-only mode). 


Miscellaneous Text Configuration Statements 



The following statements allow'you to define, various text strings of 
a miscellaneous nature: 


MtSC#Q1 TEXT <text> 

No queued messages available. This text is shown to a user who has 
executed UltraChat with a /QD switch on the Opt Data of the 
calling menu entry, and there arc not queued messages to be 
displayed. 
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MI SC#02 TEXT <lext> 

Press any key prompt, This text is shown by UltraChaL in any area 
where, the display is paused pending a user’s keypress. In most 
cases, this simply says 'Tress any key to continue” 

MISC#03_TEXT <taxt> 

Logon announce text. This text is shown to other users who are in 
a window of opportunity alerting them that a user has logged onto 
the system, i.e,, this is the logon announcement string. 

M1SQ#C4_TEXT <tpd> 

Header string for read prompt entry. This text is shown to a user 
who types a forward slash (/) at a TBBS message read prompt to 
enter the chat environment. 


Ml SC#05_TEXT <text> 

Exit chat message. This text is shown when a user leaves the chat 
environment by any route other than the TBBS message read 
prompt. 

MISC#06 TEXT <text> 

Exit chat message (from read prompt). This text is shown when a 
user leaves the chat environment and return back to the TBBS 
message read prompt, 

MISC#67 TEXT <text> 

Removed from private channel message, This text is shown to other 
users when they are kicked out of a private channel, either with the 
uninvite” command, or when the hosting user lugs off or drops 


carrier. 




_ Chapter 3: Command Reference 

MI$C#08 TEXT <text> 


Kill line acknowledgment. This test is shown to a user when the 
enter the keystoke designated as the ‘‘hill line” keystroke, defined 
with the KILL LTN’EJKEY configuration statement. 


M tSC#Q9 TEXT <text> 

Public chut banner. This text is shown to the user once when they 
oiler a public chat channel. 


MISC#10 TEXT <text> 

Logon announcement generated alert. This text is shown, to a user 
when their logon is announced to other users online. 


MISC#11_TEXT <texl> 

Two ininuLe warning. This text is shown to a user when their chat 
time limit is two minutes from expiring. 


MISC#12_TEXT <;text> 

One minute warning. This text is shown to a user when their chat 
time limit is one minute from expiring. 


M ISC #13 TEXT <text> 

Time expires warning. This text is. shown to a user when lheir chat 
time limit has expired. 


MISC#14 TEXT <tex1> 

Two minute warning, This text is shown to a user when their chat 
inactivity timeout or chat time limit is two minutes from expiring. 


MISC#15 TEXT <text> 

One minute warning. This text is shown to a user when their chat 
inactivity timeout is one minute from expiring. 
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MISC#16 TEXT <text> 


Time expired warning. This text is shad'll to a user when their chat 
inactivity timeout has expired. 


Color Changing Statements _ 

Come UltraChat displays me have color settings associated with 
them. These configuration statement allow you to set these colors 
by using ANSI escape sequences. (ANSI escape sequences arc 
listed toward the end of Chapter 2 in your TBBS manual.) 

IMP( XRTANT NOTE: You can override these color settings on a 
text display by text display basis by simply embedding ANSI escape 
sequences into any text string in the UltraChat configuration file. 


COLOR#01 TEXT <ansi sequence > 

Local typing color. This is Lhe color of the Lyping performed by a 
user within the chat environment. 


COLOR#Q2 TEXT <ansi sequence > 

Remote typing color. This is the color of the typing performed by 
other users within the chat environment. 


COLOR#03 TEXT <ansi sequence > 

System typing color. This is the color of the typing performed by 
the system itself (error messages, who’s online displays, etc.). 


CO LOR #04 TEXT <ansl sequence> 

Highlight color. This is the color that will be used to highlight Ibe 
ty ping of another user when the highlight command is executed. 
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Channel Changing Commands _ 

UllraChat uses the name channels to express or designate where a 
user is in Lhe chat environment at a given moment. Although often 
labeled “charnels’' to users, some chat systems do not refer to these 
places by that name. Sometimes they are conferences, chat sections, 
forums, etc. Whether you catl them channels or not as far as your 
users arc concerned, places to be in Lhe chat environment are 
referred Lti and configured by that name within UltraChat. 


All the channel changing commands follow this syntax: 


CHANNEL# xxCHD 

CHANNEL# KKCOtIFIRM 
CHANNEL #XX_C HANPMT 
CH ANN EL # XXPWPMT 
CHANNEL # X XE NTRY 
CHANNEL#XX_EXrr 
CHANNEL# XX_BADNUM 
CHANKEL #x x__NOTNUM 
CHANNEL #XX_NOTINV 
CHANNEL #XX BADPW 


Command 

Response 

Prompt 

prompt 

Remote Display 
Remote Display 
Error Message 
Error He b sage 
Error Message 
Error Message 


Where “xx” is the channel command number from 01 to 07 (see 
below for specifics). 


CHANNEL#Q1 CMP 

Channel change. CHANNEL#fJ1_CMD is the basic channel 
change command, and allows a user to change from one public 
channel to auother public channel. 

CHANNEL#Q2 CMP 

Private channel toggle. CflANNEL#02_CMD switches a user 
back and forth, in and out of their own private channel and the 
public channel they were last in. 
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CHANNEL#03 CMD 


Goto another user’s private chat channel. CHANNEL#03 CMD 
accepts a user's name and goes to that private chat channel, assum¬ 
ing that they arc allowed (have been invited) to be there. 


CHANNEL#04_CMD 

Goto another user’s private chat channel with password. CHAN* 
NEL#04_CMD is identical in function to CHANNEL#f)3_CMD, 
except that it accepLs a password and performs a comparison 
against the password set for the private channel they want to go to. 
Assuming the password matches and the user is otherwise allowed 
(have been invited), they are switched to that channel. 


CHANNEL#05_CMD 

Goto another user’s private chat channel with invite override. 
CHANNEL#05_CMD operates just like CHANNEL#<B CMD, 
except that it ignores the invite status and goes to the desired 
channel without checking whether they are allowed (have been 
invited). Primarily of value to sysops. 


CHANNEL#06_CMD 

Goto another user’s private chat channel with password and with 
invite override. CHANN EL#06_CMP operates just like CHAN- 
NEL#04_CM D, except that it ignores the invite status and goes to 
the desired channel without checkiug whether they are allowed 
(have been invited). Primarily of value to sysops. 


CHANN EL#07_CMD 

Go to the channel you were in when you entered chat. This com¬ 
mand allows a user to return to the channel they were in Initially 
when (hey entered chat. It is of particular interest to a user who 
entered chat in a named conference, then went (o a numbered 
channel, and wants to return to the named conference. For ex¬ 
ample, this is similar to the /Q command in TBBS chat when that 
command is executed from a CB channel. 
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C HAN NEL#XX_CQN FIRM 

Comm and confirmation (response). This is the text shown to the 
user who is issuing the channel change command to confirm that 
the channel change command has been successfully executed. It is 
issued after the channel change command is completed. U applies 
to all CHAXNEL#xx_CMD commands. 


CHANNEL#XX_CHANPMT 

Channel entry prompt (prompt). This Is the prompt shown to the 
user to ask for the channel to go to. tt is used with all CHAN- 
NEL#xx C'MJD commands. The user’s input may he a channel 
number (as For the CHANNEL#[I1„CMD command), or a user 
name (us for the CHANNFJ .#03_CMD and simil ar commands). 


CHANNEL#xx PWPMT 

Password entry prompt (prompt). This is the prompt shown to the 
user to ask fur a password before moving to the desired private 
channel. It is used with the CHANNEL#l)4_CMD command. 


CHANNEL#xx ENTRY 

Channel entry notification (remote display). This is the text shown 
to other users in the channel when the user issuing the channel 
change command enters the channel they switched to. It applies to 
all CHANNEL#xx_CMD commands. 


CHANNEL#xx EXIT 

Channel exit notification (remote display). This is the text shown to 
other users in the channel when the user issuing the channel change 
commands leaves the channel they arc in to go to another channel. 
It applies to all CHANNEL#xx_CMD commands. 


CHANNEL#xx BADNUM 

Invalid number entered (error message). This error message is 
shown io the user when they enter an invalid channel number when 
prompted, ll is used with the CI1ANNEL#01_CMD command. 
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CHANNEL#xx NOTNUM 


Input was not numeric (error message). This error message is 
shown to the user when they enter a non-numeric value when 

prompted for a channel number. JL is used with the 
CHANNEL#Ctl_CMD command. 


CHANNEL#xx NOT1NV 

Not invited error (error message). This error message is shown to 
the user when they attempt to go a private chat charnel to which 
they have not been invited. It applies to the CHANNEL#03 CMD 
and CHANNEL#04_CML> commands. 


CHANNEL#XX BADPW 

Bad password error (error message). This error message is shown 
to the user when they attempt to go to a private, password- 
protected chat channel, but the password they provide does not 
match the password set for the desired private channel. U applies 
to the CHANNEL#04_CMD command. 


General Chat Commands 


While within the chat environment, UltraChat offers a selection of 
commands to take a user into chut mode from other operating 
modes of UllraCh at, for the general purpose of going to one- on-one 
private chat. These general chat commands allow you to tailor chat 
entry to your own needs. All the general chat commands follow'this 
syntax: 


CHAT#XX_CMD 

C K AT 1 XX_C QNF IRM 
CKATfxx_PROMPT 

CHAT#XX_EXIT 

CHAT#XX_REMOTE 
C HAT # x x_NOC HAT 
CHAT#xx SELF 


Command 

Response 

Prompt 

Remote Display 
Remote Display 
Error Message 
Error Message 


Where * ! xx” is the general chut command number from.01 to 06 (see 
below for specifics). 
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Ask a user ro chat, aud wait far that user. This command is designed 
Lo emulate the functionality of the Oracomm /BRING command 
within the chat environment. It allows a user to issue a command to 
request private chat nf a anther user. The target user is alert ed that 
someone wants Lo chat wilh them. The user who makes the request 
goes into a wailing mode for the target user to join them in chat. If 
the target user chooses to respond to the chat request, both users 
W'ill be placed in one on one private chat mode, and will remain 
thereuntil they exit. 


CHAT#02 CMD 

Ask a user to dial, and proceed into the chat environment. This 
command is designed to emulate the functionality of the Oracomm 
/CALL command within the chat environment. It allows a user to 
issue a command to request chat of another user. The large! user 
is aierLed lhaL someone wants to chat with them. The user who 
makes the request can proceed to the usual chat facilities (enter 
public chat, etc.) and does not explicitly wait for the target user Lo 
join them. 


CHAT#03 CMD 

Enter main public chat channel, Oraconun style. This command is 
designed primarily lo allow entry lo the chat environment from the 
TUBS message read prompt. It enters chat in an Oracomm-sLyle 
mode, where the user is shown a list of who is online, andean either 
go to public chat or select a user lo chut wilh by number from the 
list shown. (The user could also abort the chut entry if desired.) 


CHAT#04 CMP 

Enter main public chat channel, directly. This command is designed 
primarily to allow’ entry to the chat environment from the TBBS 
message read prompt. It eniers the chat environment directly, 
taking the user to the main public chat channel without any inter im 
steps. 
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CHAT#05 CMD 


Ask a user to chat, and wait lbr that user while still operating. This 
command is identical in function to the CHAT#0i_CMD com¬ 
mand, but instead of forcing the user to wait for the other user to 
come chat, it allows the requesting user to continue executing chat 
Commands. The requesting user is yanked immediately into chat 
when the remote user accepts the chat request. If the requesting 
user leaves the chat environment, the command is terminated. 


CHAT#06_CMP 

Ask a user to chat, and wait for that user while still operating, 2 
minute limit. This command is identical in function to the 
CKAT#05_CMD command, except that the requesting user will 
wait only 2 minutes for the other user to accept, at which time they 
are sent a message saying that the other user is not joining them and 
they arc no longer waiting. (The text of this message is contained 
in the MSC#18_TEXT configuration statement.) 


CHAT#xx CONFIRM 

Message sent confirmation (response). This response applies only 
to the CHAT#QL_CMD command. This text is shown to the user 
to confirm that his CHAT#xx_CMD command was successful, and 
that the message given was sent to the specified user in conjunction 
with his command. 


CHAT#xx PROMPT 

Message input prompt (prompt). This prompt applies only to the 
CHAT#01CMD and CHAT#02_CMD commands. It is shown 
in the user to request that the user enter the desired message to 
send in conjunction with the command. Once entered, the message 
is sent U> the user who is the target of the command. 


CHAT#XX_EXIT 

User left chat announcement (remote display). This remote display 
applies only to the CHAT#(]1 CMD aodCHAT#02_CMD com¬ 
mands. Tt is shown when the user issuing the corresponding com- 
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mand exits the ehat channel, cither entirely, or when moving to 
another channel. 


CHAT#xx REMOTE 

Chat request message (remote display). This rerunLe display ap’ 
plies only to the CHAT#0 l_CM D command. It is shown Ic a target 
user when another user executes a CHAT#01_CMD command, 
and alerts that target user that the initiating user wants to ehat with 
them, 


CHAT#xx NOCHAT 

Target user is in no chat mode (error message). This error message 
applies only to the CHAT#01_CMD command. Tt is displayed to 
the inh luting user when they issue a CHAT#01_CMD co mma nd, 
and the target user is currently in "no chat” mode and unable to 
accept the request. 


CHAT#xx SELF 

Target user is the same as initiating user (error message). This error 
message applies only to the GHAT#(11_CMD command. Tt is 
displayed to the initiating user when Lhey issue a Cl IAT#(]J_CMD 
command, and they are the target user, Le., the user is trying to chat 
with him.s eIf, 


Private Message Commands _ 

UltraChat offers a variety of ways to send private messages - 
messages sent by one user to anorher specific user that nobody but 
the sender and recipient can see. Private messages arc used for user 
to user paging, so called whisper commands, and soon. UltraChat 
offers nine (9) functionally identical private message commands, 
which allows you to configure to up nine (9) different styles or types 
of private messaging in the chat environment. 
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All the private message commands fellow this syntax: 


PRIVATE4XXCMD 

PRIVATE #xx_CONFIRM 
PRIVATE # XX_NAMEPMT 
PRIVATE #XX_MSGPMT 
PRIVATE #XX_E MPT Y 
PRIVATE #XX_REMOTE 
PRIVATE #xx_NOCHAT 
PRIVATE♦XX ERROR 


Command 

Response 

Prompt 

Prompt 

Remote Display 
Remote Display 
Error Message 
Error Message 


Where “xx* is the private command number from 01 to 10 (sec 
IjcIow for specifies). 


PRIVATEfrOI CMP - PRIVATE#09_CMD 

Private message sending. The FRlVATE#0l_CMD through 
PRWATE#(I9_CMD commands are functionally identical, and all 
are interchangeable, allowing you to configure up to nine (9) 
separate private message sending modes or types. All allow a user 
to send a private (noL displayed in public chat) message to another 
user online. If the receiving user is in the chut environment, they 
roecivc the message immediately. If the receiving user is outside of 
the chat environment, they will receive the message al the next 
window of opportunity. 


PRIVATES0 CMP 

Private message resend. This command is identical to the 
PRIVATE#01 _CMD through PT?T VATE#D9_CMD commands - 
except that no user name or ID is required to be entered by the 
user. Instead, it sends a private message to the last person the user 
send a private message to. It is intended to allow you to provide a 
shortcut command that gives users an easy, quick way to converse 
repeatedly with another user privately while still participating nor¬ 
mally in a public chal chantici. 


PR|VATE#XX CONFIRM 

Command confirmation {response), 'This is the text shown to the 
user who is Issuing the private message command to confirm that 
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the private message command has been successfully executed- It is 
issued after the private message is delivered to the receiving user. 


PRIVATE#XX NAMEPMT 

User name prompt (prompL). This is the prompt shown to the user 
to ask for the name (or other identifier) of the user they wish to 
send the private message to, if the name (or identifier) was not 
provided as part of the command. 


PR1VATE#xx MSGPMT 

Message content prompt (prompt). This is the prompt shown to the 
user to ask for the contents of the private message they wish Lo send, 
if the message content was not provided as part of the command. 


PRIVATE#xx EMPTY 

No message content provided display (remoLe display). When 
present, this command element allows a user to send a private 
message that has no message content. When the. user sends a private 
message with no content, the text associated with this command 
dement is sent instead. If this command element is not defined, 
UltraCbat requires the user ro type message content in order for a 
private message to be sem. 


PRIVATE#xx REMOTE 

Remote user display (remote display), This is the text shown to the 
remote user when ihey receive a private message from someone. 

PRIVATE#XX NOCHAT 

Receiving user in no chut mode error (error message). This is the 
text shown Lo the user issuing the private message, command when 
the user they are sending the message to (tire receiving user) is 
currently in no chat (ignore) mode. 


4 

1 
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PRIVATE#XX ERROR 


Remote user not available error (error message). This is the text 
shown, to the user issuing the private message command when the- 
user they are sending the message to (the receiving user) is not 
available (not logged in, etc-). 


Who’s Online Commands 


UltraChat offers a variety of ways for you to proride who's online 
and related displays. These displays all list various information 
about other users online or in ihe TBBS userlog. Used primarily 
for true '‘who” commands, these commands also proride a variety 
of user listing functions. All the who's online commands follow this 
syntax: 


WHO#xx_CMD 

WBO#xx_KEADBK 

WflOfrxxTOTAL 

WHO*XXj'IORttAL 

WHO#XX_IDLE 

WHO tXX_IHVISIBLE 

WHOHxx_PAUSE 

WHO#xx_PUBLIC 

WHO#XXJMYCHAN 

WHO#xx_HlSCHAN 

WHO#xx_PRIVATE 

WHO#XX_NOUSER3 

WHO#xx_HAKEPMT 

WKO#XX_ERROR 

WHO#XX ANON 


Command 

Response 

Response 

Response 

Response 

Response 

ReaponBe 

Response 

Response 

Response 

Response 

Response 

Prompt 

Error Message 
Error Message 


Where “sex” is the who's online command number from (11 to 13 (see 
below for specifics). 

Most who's online displays use repeated, sequential responses to 
form cuhiTrinar displays. For example, the WHO#01_CMD corti’ 
maud will display a response (usually Lhe WHO#01_NORMAL 
text) once for every line on. the system *- up to the line number 
designated by the LAST LINE NUM configuration statement. 
This is unlike other types of UltraChat commands that generally 
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display applicable response strings once each time the command is 
execuLed. 


WHQ#Q1 CMD-WHO#Q6 CMP 

General who’s online command. The WHO#Ul_CMD through 
WHO#06 CMD commands are functionally identical, and arc 
designed to allow you to provide up Lo six (6) different styles of 
wlu/s online user listing displays. All of these who’s online com¬ 
mands will reference all lines on your system - up to the line number 
designated by the LA$T_LINE_NUM configuration statement. 
Y riu can control which types oflincs arc displayed (in use, idle, etc.) 
through command element definitions. 


WHQ#07 CMP 

Current channel who’s online listing. This command lists the users 
who are on the same chat channel as the user issuing the who’s 
online command. 


WHQ#08 CM D 

Who's online and using chat listing. This command lists all users 
who are currently logged onto the system and who are within the 
chat environment, i.e., those users who arc using chat (whether they 
are in the current channel or not), 


WHO#Q9 CMP 

Browse the user who sent this message. This command applies only 
when executed from a TBBS message read prompt. It performs a 
browse command (normally made equivalent to the 
WHO#lO_CMD command) on the user who sent the message the 
user is currently reading. 


WHO#1Q CMP 

Browse u user. This command is designed to allow a user to browse 
another user on the system. It is normally used to display Lhe 
threc-linc bio of another user. 
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WHO#11 CMD 


List all users id reverse alphabetical order. This command is 
designed to allow a user to list all users on the system ro reverse 
alphabetical order. 


WHQ#12_CMD 

List all users in forward alphabetical order. This command is 
designed to allow a user lx> list all users cm the system in forward 
alphabetical order. 


WHO#13 CMD 

List new system users. This command is designed to allow a user to 
list all new users on the system. The NEW USERS NUM con¬ 
figuration command tells UllraChul how to control the scope of this 
listing. 


WHO#XX HEADER 

Header for who listing (response), This response applies to the 
\VHO#01 CMD through WHO#06_CMD t andWHO#f)8 CMD 
commands only. This text is the first thing shown to a user when the 
corresponding who’s online command is executed. If the display is 
arranged in a columnar fashion (as it usually is), then this text 
should feature headings for the various columns. 


WHO#xx TOTAL 

Totals line for who listing (response). This response applies to the 
WHO#01 CMD through WHO#08_CMD commands only. This 
text is the last thing shown to a user when the corresponding who’s 
online command is executed. Generally it >$ used to provide a 
summary or totals, such as how r many people arc online at the 
moment (“12 of 24 lines in use”) and the like. 


WHO#xx NORMAL 

Lis Ling display for normal user (response). This response applies 
to all WHO#xx CMD commands. This text forms the basis for all 
who’s online displays. It contains whatever text is shown to the user 
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who executed the who’s online command, i.e., the actual contents 
of the who’s online display. It is shown for every line that has a user 
that is not invisible, 


WHO#xx IDLE 

Listing display for idle user (response). This response applies to 
the WHO#01_CMD through WHO#06_CMD commands onLy. 
This text is in place of the \VnO#xx_NORMAL response for any 
lines that are idle (no user logged on). If left blank, nothing is 
displayed for idle linos. 


WHO#xx INVISIBLE 

Listing display invisible user (response). This response applies to 
the WHO#Gl CMD through WHO#Ofi_CMD commands only. 
This text is in place of the WUO#xx_NORMAL response for any 
line that have, an invisible user logged on. If left blank, nothing is 
displayed for lines with invisible users, 


WHQ#xx PAUSE 

"P to pause. S to stop” display (response). This response applies lo 
the WHO#11_CMD through WHO#13_CMD commands only. 
For the applicable who’s online commands, this text is shown prior 
to any other text, and is designed to allow the system Lo instruct the 
user lo press I’ to pause the display, or S to stop the display, since 
the displays associated with these commands can run on screen 
after screen. NOTE: The P and S keys can be changed using 
configuration statements if desired. 


WHQ#xx PUBLIC 

Header when in public channel (response). This response applies 
only to the WHO-$07_CMD command- When the corresponding 
command is used from within a public chat channel or named 
conference, this text is the first thing shown to the user in conjunc¬ 
tion with the command. It forms a header for the display informa¬ 
tion ihai follows it. If the display is arranged iu u columnar fashion 
(as it usually is), then this text should feature headings for the 
various columns. 
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WHO#xx MYCHAN 


Header when in own private channel (response). This response 
applies only lo the \VHO#07_CMD command. When the cor¬ 
responding command is used from within the user’s own private 
chat channel, this lext is the first thing shown to the user in conjunc¬ 
tion with the command, and replaces the WHO#xx_PUBLlC 
response normally displayed. It forms a header for the display 
information that follow's it. If the display is arranged in a columnar 
fashion (as it usually is), then this text should feature headings for 
the various columns. 


WHO#xx HISCHAN 

Header when, in someone clsc’s private channel (response). This 
response applies only lo the WHO#07_CMB command. When the 
corresponding command is used from within someone else’s 
private chat channel, ihis text is the first thing shown to the u&ct in 
conjunction with the command, and replaces the 
WHO#xx_PUBLIC response normally displayed. It forms a 
header for the display information that follows it, TF the display is 
arranged in a columnar fashion (as it usually is), iben this le-xt 
should feature headings for the various columns. 


WHO#xx PRIVATE 

Header when in private one-on-one chat (response). This response 
applies only to the WHO#07_CMD command. When the cor¬ 
responding command is used from within private one-cm-one chat, 
this text is the first thing shown lo the user in conjunction with the 
conun and, and replaces the WHO#xx_FUBLIC response normal¬ 
ly displayed. It forms a header for the display information that 
follows it. If the display is arranged in a columnar fashion (as it 
usually is), then this text should feature headings fur ihe various 
columns. 


WHO#xx NOUSERS 

Totals line for who listing when no users online (response). This 
response applies only to the WHO#07_CMD command. This text 
is the last thing shown to a user when the corresponding who’s 
online command is executed, and is used in replacement of the 
WHO#xx TOTAL line when there are no users to total. 
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WHO#xx_NAMEPMT 

User name prompt (prompt). This prompt applies only to the 
WHO#lG_CMD command. It is given to the user when they issue 
the corresponding who's online command and neglecL to provide a 
username or ID with the. command, tt asks the user to enter the 
name or 11 > of the user they wish to browse. 


WHO#xx ERROR 

User not found error (error message). This error message applies 
only to the WHO#09_ CMD and W1IO#10_CMD commands. It 
is given when the user designates a user name or ID that UltraChat 
cannot find in conjuncLion with the who's online command. 


WHO#xx AN ON 

Command executed on anonymous message board error (error 
message). This error message applies only to the WHO# 10_CMD 
command. It is given when the user wants to browse another user 
from the message read prompt, but the browse command is ex¬ 
ecuted from an anonymous message board (where user information 
is confidential). 


Chat Exit Commands _ 

UltraChat offers a variety of ways to leave the chat environment. 
The commands that follow all perform this function in different 
ways. All the chat exit commands follow this syntax: 

exit#xx_cmd command 

None of the chat exit commands have any command elements. 



Exrr#oi cmd 

Exit to BBS. This command allows a user to completely exit the chat 
environment and return to TRES control. This is the basic, standard 
“exit chat” command. 
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EXIT#02 CMD 


Exit private chat. This command puls the user “up” a level within 
the chat environment (and does not perform an exit from the chat 
environment). 'When a user is in private chat with someone, they 
will go back to the last public chat channel they were in before 
entering private chat. If the user is already in public chat, the 
command is ignored. 


EXIT#Q3 CMD 

Exit via logoff. This command performs the equivalent of a TUBS 
Type 10 command, logging the user off with the usual logoff status 
displays. With this command, the user leaves not only Lhe chat 
environment, but the BBS as well 


EX1T#04 CMD 

Exit via carrier drop. This command immediately drops carrier on 
the user, causing Lhem to disappear from the system. Please note 
that TBBS will still send logoff status displays to the modem before 
reselling it, so you should keep logoff information as short as 
possible so that the line will become available again as quickly as 
possible. With this command, the user leaves not only the chat 
environment, but the BBS as well. 


Help File Display Commands _ 

UltraChat gives you Lhe flexibility to designate up to nine (9) help 
files. Users can issue commands lo display the help flics you 
configure. You may. for example, wish to have one help file for 
general chat commands usage, and others for using specific fea¬ 
tures (such as private chat, the three-line bio, etc.). All the help file 
display commands follow this syntax: 

HELP# XXCMD command 

HELP # 3oi_r IL E Response 

HELP#XX ERROR Error Message 

Where “xx” is the help file display command number from 01 to Oft 
(see below for specifics). 
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HELP#01 CMD- HELP#09 CMD 


Help file display. The HELP f 0 1_CMD through HELF#09_CMD 
commands arc functionally identical, and all arc interchangeable, 
allowing you to configure up to nine (9) separate help file displays. 
All allow a user to display a help file online upon issuing the 
corresponding help keystroke. During a help file display, all Ultra- 
Chat messages will be suppressed. 


HELP#xx FILE <filename> 

Help file name (response). This command element allows you to 
designate the drive, path and filename of the help file associated 
with Lhe help command. When the user issues the corresponding 
help command, this file will be opened and displayed. During the 
help file display, all messages from UltraChat arc suppressed. 


HELP#xx ERROR 

File missing error (error message). Tins element allows you. to 
designaLe text lhaL is shown to the user when the help file is missing 
(or cannot be located byUltraChat). In any situation where the user 
attempts to display a help file, and the help file cannot be located, 
this error message text will be displayed in lieu of the file. 


Text Display Commands _ 

UltraChat allows you to configure up lo nine (9) text strings which 
can be associated to a chat command and display every lime that 
command is issued. These arc usually used for information displays, 
such as chat version, system name, etc. By using insertion 
parameters, you can also use them to have commands that display 
the current lime and dale, or other dynamic information. All the 
text display commands have this syntax: 

type# xx_CMD C oiranand 

TYPE # X Jt_TE X T Response 

Where u xx” is the text display command number from 01 to 09 (see 
below for specifies). 
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TYPE#01 CMD - TYPE#19 CMD 


Generic text display commands. The TYPE#CI1_CMD through 
TYPE#19_CMD coaunands are functionally identical, and all arc 
interchangeable, allowing you to configure up to nineteen (19) 
separate text displays. All allow a user lo display a text string on Hue 
upon issuing the corresponding Help keystroke. 


TYPE#xx TEXT 

Text string to display (response). This command element lets you 
designate the text string that will be displayed 1 1 > (he user when Ihe 
corresponding command is Issued by a user. This is standard text, 
aod can include insertion parameters lor dynamic displays, 


Status Toggle (On to Oft, Off to On) Commands _ 

UlLruChal offers a varieLy of toggles, which allow the user to toggle 
Ihe state of a status item within the chat environment. Toggling 
means that if something is turned off (disabled), it will be turned 
on (enabled). Tf ids turned on (enabled), it w r ill be turned off 
(disabled). In olber words, ihe current slate of the status item will 
be changed or toggled. 

The status items that can be toggled include; a useds. invisible status, 
a user’s no chat (ignore) status, logon announcement receipt status, 
shortcut commands allowed status, and moan macro status. All the 
Status toggle commands follow this syntax: 

TOGGLE#xx CMD Command 

TOGGLE #xx ott Response 

TOGGLE#xx_OFF Response 

Where “xx” is Lhe status toggle command number from 01 lo()5 (see 
below for specifics). 


TOGGLE#Q1_CMD 

Toggle invisible status. This command allows a user to toggle his 
invisible status. When invisible, a user will not show up in any who’s 
online listings under the control of UltraChat until they toggle the 
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stalus oil. The invisible state of a user is saved between calls. Nole 
that a user cannot issues a who's online command while invisible, 
and will be made visible upon entry to chat. 


TQGGLE#02 CMP 

Toggle no chat status. This command allows a user to toggle his no 
chat status. When no chat stalus is on (enabled), the user will show 
on who’s online listings, but will not be available to other users in 
the chat environment lor paging, etc. until they toggle the status off. 


TOGGLE#03 CMP 

Toggle logon annoimcemeni suppression. This command allows a 
user to toggle the logon announcement suppression status. When 
this status is enabled, logon announcements generated by Ultra- 
Chat will be suppressed. (Logon announcements arc messages 
broadcast to users to notify them that someone has logged onto the 
system.) Logon announcements remain suppressed uutil the status 
is toggled off. 


TQGGLE#04_CMP 

ToggLe shortcut commands required. This command allows a user 
to toggle whether shortcut chat commands arc required or not. 
When this status is enabled, (he user must use shurLcul commands 
in the chat environment. When this status is disabled, long torn) 
commands as well as shortcut commands are allowed within the 
chat environment. This is useful is a user wants to make sure what 
they type will not be interpreted as a command 


TOGGLE#05 CMP 

Toggle moan macro staLus, This command allows a user Lo toggle 
whelher they can use moan macro commands in the chat environ 
juent. When enabled, the User can use any defined moan macros 
they have access to. When this status is disabled, moan macros 
minimi be issued by the user. 
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TOGGLE#xx ON 

Status enabled confirmation (respon.se). This is the text shown to 
the user when a status item is toggled on (enabled) to confirm that 
the toggle command was successful and to indicate the new state of 
the corresponding status item. 


TOGGLE#xx OFF 

Status disabled confirmation (response). This is the text shown to 
the user when a status item is toggled off (disabled) to confirm that 
the toggle command was successful and to indicate the new state of 
the corresponding status item. 


Status Forced On (Enable) Commands _ 

Besides the toggles describee! previously, UUraChat offers 
equivalents for all the toggles that force a given status item on 
(enabled). The status item is forced on, regardless of its current 
state. If it's currently off, it will be. turned on; if it’s already on, 
forcing it on will result in no change. 

The status items that can be forced on include: a user’s invisible 
status, u user’s no chat (ignore) status, logon announcement receipt 
status, shortcut commands allowed status, and moan macro status. 
All the status forced on commands follow' this syntax; 

on#xx_cmd command 

onUxx text Response 

Where *'xx lf is the status forced on command number from 01 to 05 
(sec below’ for specifics). 


ON#Q1 CMP 

Force on invisible status. This command allows a user to force on 
his invisible status. When invisible, a user will not show up in any 
■who’s online listings under the control of Ultra Chat until they turn 
the status off. The invisible state of a user is saved between calls. 
Note that a user cannot issues a who’s online command while 
invisible, and will be made visible upon entry to chat. 
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ON#Q2_CMD 

Force no chat status. This command allows a user to force on his 
no chat status. When no chat status is on (enabled), the user will 
show on who’s online listings, but will not be available to other users 
in the chat environment for paging, etc. until they turn the status 
back off. 


ON#Q3_CMD 

Force suppress logon announcements. This command allows a user 
to force on the logon announcement receive status. When this status 
Ls enabled, logon announcements generated by U ItraChat are sup¬ 
pressed. (Logon announcements are messages broadcast to users 
to notify them that someone has logged onto the system.) 


ON#Q4 CMP 

Force on shortcut commands required. This command allows a 
user Iq for oe on the shortcut chat commands required status. V/hcn 
this status Ls on (enabled), the user must use shortcut commands in 
the chat environment. When this status is off (disabled), long form 
commands as well as shortcut commands are allowed within the 
chat environment:. 


ON#Q5 CMP 

Force on moan macro status. This command allows a user to force 
on whether they can use moan macro commands in the chat en¬ 
vironment. When on (enabled), the user can use any defined moan 
macros they arc allowed to use. When this status is off (disabled), 
moan macros cannot bo issued by the user. 


ON#xx TEXT 

Status enabled confirmation (response). This is the text shown to 
the user when a siaLus iLem is forced on (enabled) to confirm that 
the command was successful and to indicate the new staLe of the 
corresponding staLus item. 
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Status Forced Off (Disable) Commands 


Besides the toggles described previously, UltraChat offers 
equivalents for all the toggles that force a given status hem off 
(disabled). The status item is forced off, regardless of its current 
state. If it’s currcurly on. it will be turned off; if it’s already off, 
forcing it off will result in no change. 

The status items that can be forced off include: a user’s invisible 
status, a user’s no chat (ignore) status, logon announcement receipt 
status, shortcut commands allowed status, and moan macro status. 
All the status forced on commands follow this syntax: 

OFF#xx_CMD command 

OFFttxx TEXT Response 

Where ‘hex” is the status forced oft command number from fll to 05 
(see below for specifics), 


OFF#Q1 CMP 

Force off invisible status. This command allows a user to force off 
his invisible status, making the user visible. When visible, a user wilt 
show up in any who's online listings under the control of UltraChat 
until they turn the status on again (at which point they become 
invisible and not listed in who’s online displays). The invisible state 
of a user is saved between calls. 


QFF#02 CMP 

Force off no dial status, This command allows a user to force off 
his no chat status. When no chat status is off (disabled), the user 
will show on who’s online listings and will be available to other users 
in the chat environment for paging, etc. until they turn the status 
back on. (When the status is on, the user is not available to oLher 
users.) 


OFF#Q3 CMP 

Force off logon announcement suppression (allow an¬ 
nouncements). This command allows a user to force off the logon 
announcement receive status. When this status is disabled, logon 


3-4* 






Chapter 3: Command Reference 


announcements generated by UkraChat arc shown to the user. 
(Logon announcements are messages broadcast to users to notify 
them that someone has logged onto the system.) 


OFF#Q4 CMP 

Force off shortcut commands required. This command allows a 
user to force off the requirement to use shortcut chat commands in 
the chat environment. When this status is on (enabled), the user 
must use shortcut commands in the chat environment. When this 
status is off (disabled), long form commands as well as shortcut 
command* arc allowed within the chat environment. 


QFF#05 CMP 

Force off moan macro status. This command allows a user to force 
off whether they can use moan macro commands in the chat 
environment, When on (enabled),, the user can use any defined 
moan macros they are allowed to use. When this status is off 
(disabled), moan macros cannoL be issued by the user. 

OFF#xx TEXT 

Status disabled confirmation (response). This is the text shown to 
the user when a status item .is forced oil (disabled) to confirm that 
the command was successful and to indicate the new state of the 
corresponding status item. 


Three-Line Bio Commands 


UltraChal offers support for the entry and storage of a thrcc-linc 
bio on a user by user basis. This feature, patterned after simil ar 
features in other BBS chut systems, allows you to conveniently and 
easily offer brief user profiles to your callers. The thrcc-linc bios 
can then be displayed as a part of “who’s online” displays, or can 
be looked-up by users online from within tlic chat environment. 
kJJtr aChat otfers two commands to allow the entry and manipula- 
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tioQ of the thrcc-linc bio feature. The three' line bio commands both 
follow'this syntax 

BIOUxx CMD Command 

BIO#xx_YN prompt 

Blo#xx_JPROMPT ' Prompt 

Where “xx” is the three-line bio command number from 01 to 02 
(see below for specifics). 

B1Q#01 CMP 

5el initial three-line bio. This command allows a user to set their 
tbrce-li nc bio for the first time. The prompts (described below) 
should reflect LfaaL this command is used when the user is setting 
their bio for the first time. 


B1Q#02 CMP 

Change three-line bio. This command allows a user lo change their 
existing ihrcc-line bio. This command should be available to users 
conveniently if you use the three-line bio feature on your system. 
The prompts (described below) should reflect that this command 
is used for changing a bio, ns opposed to setting it initially. 

BIO#yx_YN 

Ask yes/no whether to set/updale (prompt). This prompt is shown 
to the user when they initiate one of the BIO#xx_CMD commands. 
It is designed to prompt the user whether lo proceed with the 
command. It expects a yes/no response from Lhe user. If they answer 
yes, then the command continues to be executed. If they answer no, 
the command is aborted. 


BIO#XX PROMPT 


Ask for three-line bio (prompt). This prompt is shown to the user 
when they initiate one of Lhe BIO^xx_CMD commands, and have 
confirmed (through the BIO#xx_YN prompt) that they wish to 
proceed. This prompt should ask the user to enter their three-line 
bio. It should also give introductory information about the bio itself 
if applicable, and should note that the user should NOT press Enter 
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unlit they are done entering Ihe bio. Refer to the supplied sample 
configurations for examples. 


Edit Commands 


UltraChat offer*? a variety of settable, editable options for users. 
These include announce strings (geuerally shown wilh who’s o nlin e 
displays), private channel topic name, and private channel 
password. When you wish any of these features Lo be. active and 
available for users, configure the desired command within Ultra- 
Chul. All the edit commands have the following syntax: 


EDIT#xx_CMD 

EDIT#XX_PROMPT 
EDIT#XX_CONFIRM 
EDIT#XX ERROR 


Command 
Prompt 
Response 
Error Message 


Where 'bet” is the edit command number from 01 to 04 (see below 
for details), 


EDIT#01 CMP 

Set or change announce string. This command allows a user to set 
or change their announce string. The announce siring is generally 
used as a component of a who's online display, and Lscmphtyed by 
users to customize what is shown by their name during a who's 
online display, and so on, acting as a user-settable vanity item. 


EDIT#Q2 CMP 

Set topic name for private chat channel. This command allows a 
user to specify a name or topic for their private chaL channel. This 
name can then be used on who’s online displays and the like to 
identify the topic, subject, name, etc. of a user’s private channel. 
This is primarily a vanity item, but is often used by a caller to use 
their private channel to setup a particular chat topic and foster 
communication on that topic. 
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EDIT#03 CMD 


Set password for private chat channel. This command allows a user 
to specify a password for their own private chat channel. When set, 
another user who wishes to go to that private channel must know 
and provide the password before being allo wed access. 


EDn~#04_CMD 

Change user handle (namc/ID override). This command allows a 
user to enter a handle that will be used within Ihe chat environment, 
and which overrides the user’s regular name or user ID for the 
duration of their session. Handles are saved between sessions so 
that a user can define a handle and keep it for on-going use. Handles 
arc use d exaedy as entered by the user, and arc not case-sensitive. 


EP1T#XX PROMPT 

Prompt user for desired command input (prompt), This prompt 
asks the user to enter the information for the corresponding com¬ 
mand. For example-, with the EDIT#tB_CMD command, this 
should prompt the user to enter their desired private chat channel 
password. 


EPrr#xx CONFIRM 

Confirm acceptance of command input (response). This response 
is shown to the user when they have successfully entered the 
information expected by the corresponding command. For ex¬ 
ample, with the EDIT#03_CMD command, this should confirm 
that the password they input has been accepted. 


EPIT#XX ERROR 

Handle entered is in use error (error message). This error message 
is shown when a user executes un EDIT#04_CMD command to 
enter or change their handle, and the handle they entered is the 
name or ID of a user on the system, or is the same as the handle of 
someone else who is online at the moment. 
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Interaction Commands 


UllraChat offers a variety of interaction commands. These com¬ 
mands allow a user to control various aspects of their interaction 
wiLb other users in the dint environment. Examples of this interac¬ 
tion indude a user being able to ignore or squdeh another user’s 
chatter, invite or uninvitc users to their private channel, and so on. 
All interaction commands follow this syntax: 


INTERACT# xji_CMD 

IHTERACT #xx_ON 
T NTERACT # xx_ON 2 
I NTERACT # XX 0 FF 

Interact#xx_o F F 2 

I NTERACT# XX_A1L ON 
INTERACT# XX_AL L OFF 
INTERACT# JUC_NAM£PMT 
INTERAC T # XK REMOVE 
INTERACT# XX_RE MOTEINUC 
INTERACT#XX_REMOTE 
INTERACT#XX ERROR 


Command 

Response 

Response 

Response 

Response 

Response 

Response 

Prompt 

Remote Display 
Remote Display 
Remote Display 
Error Message 


Where “xx” is the interaction command number from 01 to 07 (sec 
below for details). 


INTERACT#01 CMP 

Ignore a user or all users. This command allows a user to mark 
another particular user, nr all other users, as ‘'ignored.” If a user 
provides another user's name or ID when issuing this command, 
that one user is affected; without a name or 1D given, (his command 
will apply to all users, When a user is being ignored, none of their 
message traffic in the chat environment will be displayed, i.e,, their 
chat wdl be suppressed, when ignored, a user’s private chat com¬ 
mands as well as comments in a public channel will not be displayed 
to the user who initiated the ignore command. (The user’s chat 
traffic is still shown to all others who are not ignoring that user.) 


I NTERACT# 02 CMP 

Remember a user or all users. This command is the functional 
opposite of the INTfciRACT#Ol_C!MD command, ft allows ihe 
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user to mark another particular user, or all users, as “remembered.’’ 
If a user provides another user’s name nr ID when issuing this 
command, that one user is affected; withonL a name or ID given, 
this command will apply to all users. When a user is remembered 
(i.c., not ignored), all of their message traffic in the chat environ¬ 
ment will be displayed (not suppressed). 


INTERACT#03 CMP 

Turn ignore status on and off. This command is closely related to 
the IN T BRACT# G1_CMD and INTEJRACT#C2_CMD com¬ 
mands. But where those commands force ignore or remember 
mode, this command allows the user to input which mode they 
desire. When issuing this command, a user may optionally provide 
a user name or ID, in which case the command applies only to that 
user. When no name or ID is given, the command applies to all 
users. Besides a user name or ID, the user can give the keyword 
“ON” or “OFF” lhal designal es how the comm and is to behave, ON 
meaning ro ignore, OFF meaning to remember. If do ON or OFF 
keyword is provided, ON (ignore) is assumed. Refer to the previous 
INTERACT#xx_CMD commands for an explanation of ignore 
and remember. 


INTER ACT #04_CM D 

Invite a user or users to your private channel. This command allows 
a user to invite another user (or all users) to their private chat 
channel. (The UliraChal default is uninvited; Lhis command allows 
a user to invite someone who previously was uniuvited) If a user 
follows this command with a user name or ID, die invite command 
applies only to that user. Tf no name or ID was specified, then all 
users arc invited. 


IKm£RACT#05 CMP 

Unin vile a user or users from your private channel. This command 
is ihe functional opposite of the INTERACT #04 CMD command. 
Instead of inviting a user to come to your channel, it marks another 
user or users as uninvited, and thereby unable to come to your 
private channel. If a user is already in the private channel and they 
utc uninvited, they arc kicked out of the private channel and 
returned to the previous public channel they were in. If a user 
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issuing this command follows it with a user name or ID, the uninvite 
applies only to the named user. If they omit the name or ID, the 
uoinvite command applies to all users. 


INTERACT#06 CMP 

Highlight a user's chatter. This command allows a user to "high¬ 
light' 5 the chatter (chat traffic) of another user. This command 
expects the person issuing the command to provide the name or ID 
of the user whose chat traffic they wish to highlight. When a user is 
marked as highlighted, the- color designated by the 
COLOR#Q4_TEXT is sent just before chat traffic from this user. 
COL( )R#(!4 TEXT should, therefore, be configured to show ten 
in. a different color or intensity than normally used. A maximum of 
ten (10) users cun be high light ntl at one lime. 


INTERACT#07 CMP 

Unhighlight a user’s chatter. This command is the functional op¬ 
posite of the INTERACT #06_CMD command. It allows a user to 
tell LltraChat to stop highlighting the chat traffic from the desig¬ 
nated user. Like the ENTERA CT#06_CMD command, this com¬ 
mand accepts the name or ID of a user whose dial traffic should 
stop beiog highlighted. If that user’s traffic not highlighted already, 
this command will have no effect. 


INTERACT#xx ON 

User invitatinn/ignore response (response). This response is dis¬ 
played to a user when Lhey have invited another user to their private 
channel. This is the response shown when the invitation is made 
from the inviting user’s private channel Also used to acknowledge 
that a user has chosen to ignore another user. 


INTERACT#xx ON2 

User invitation not made from private channel response 
(response). This response applies only to the INTER- 
ACT#04 CMD and INTERACT #<J5__CMD commands. This text 
is shown tn a user when he invites another user to his privaLe 
channel, but that invitation is made when the inviting user is not 
currently located in his own private channel (i.c., made from public 
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channel or someone elsc’s private channel). Also used to acknow¬ 
ledge that a user has chosen to ignore another user. 


lNTERACT#xx OFF 

User uninvitate response (response). This response is displayed to 
a user when they have uninvited another user from their private 
channel. This is the response shown when the uninvite is made from, 
the uninviting user’s private channel. A Iso used to acknowledge that 
a user has chosen to remember another user. 


INTERACT#™ OFF2 

User uninvite not made from private channel response (response). 
This response applies only to the INTERACT#04 CMD and IN¬ 
TERACT #05_CMD commands. This text is shown to a user when 
he uninvites another user from his private c hannel, but that uninvite 
is made when the uninviting user is not currently located in his own 
private channel (i.c, p made from public channel or someone else’s 
private channel). Also used to acknowledge that a user has chosen 
to remember another user. 


INT ERACT#xx ALLQN 

All users invited response (response). This text is shown 10 a user 
when he invites all users to his private channel with a single com¬ 
mand (normally an invite command that has no specific user desig¬ 
nated). Also used to acknowledge that all users have been ignored. 


INTERACT#™ ALLOFF 

All users uninvited response (response), This text is shown to a user 
when he uninvites all users from his private channel with a single 
command (normally an uninvite that has no specific user desig¬ 
nated), Also used Lo acknowledge that all users have been remem¬ 
bered. 


INTERACT#™ NAMEPMT 
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when they issue an invite, or uninvite command and neglect to 
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provide a user name or ID with the command. It asks the user to 
enLer the name or ID of the user they wish to invite Or uofovile. 
NOTE: UltraChat will also accept the keyword "ALL" in lieu of a 
user name or ID, indicating to invite or uninvile all users, and this 
prompt should reflect that option it' desired. 


INTERACT#™ REMOVE 

User was uninvited and kicked out of channel (remote display). 
This remote display applies only tn the 1NTER ACT#Q4_CMD and 
INTERACT#05_CMD commands. This text is shown to a user 
who is in another user’s private ch anne l, and has just been uninvited 
from and removed from that, channel by the other user (the user 
whose private channel it Ls). This text is ONLY shown to a user who 
has been uninvited when that user is already in the private channel 
he has been uninvited from. If the user Ls elsewhere (in a public 
channel, etc.) and gets uninvited, nothing is shown. 


INTERACT#™ JtEMOTEINUC 

User invitation, in UltraChal (remuLe display). This remote display 
applies only to the 1NTERACT#04 CMD and INTER- 
ACT#05_CMD commands. This text is shown to a user who has 
been invited to another users private channel. This particular text 
is shown if the user who is invited is within the chat environment 
(i.e.,in UltraChat) already. 


INTERACT#xx_REMOTE 

User invitation not in UltraChal (remote display). This remote 
display applies only to the INTERACT#Q4 CMD and INTER¬ 
ACT #05 CMD commands. This text is shown to a user who has 
been invited to another user’s private channel. This particular text 
is shown if the user who is invited is NOT within the chat environ* 
meul (i.e., is not in UltraChal) already. 


INTERACT#™ ERROR 

Invitation error (error message). This text is shown to a user when 
an error occurred during the handling of their invite/ujimvitc com¬ 
mand. Such an error usually results from the entry of a name of J D 
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of a user who is rot online when the invite or nninvite command is 
issued. 


Action Commands 


UltraChat supports action commands. This term refers to a set of 
special commands within the chat environment, which are a form 
of generic moan macro. In Major BBS chat, this is usually called a 
“generic action’* or M GA*’ command, In essence, an action com¬ 
mand allows a user to create on-thc-fly a special tailored remote 
display that will be shown to all the users who are in the channel 
with the user who Issued the action command. In most ways an 
action command is the same as a user simply typing something into 
the chat channel - but the remote display is different, normally 
formatted as though the user issued a moan macro. 

For example, in Major BBS mode, a user named Joe Blow might 
type the following: 

ga is blushing in a pewky scarlet color... 

and other users on the. channel might see something like this: 

Joe Blow is blushing in a pewky scarlet color... 


Since you configure actio a commands, they can have whatever 
behavior you want them to have. They follow Lhis syntax: 

ACT XON #XX_CMD Command 

ACTION#xx_CONFIRM Response 

ACTIONjfxx_REMOTE Remote Display 

Where “ra” is the action command number from 01 to 09 (see below 
for details). 


ACT1ON#01 CMD-ACTI0N#Q9 CMP 

Action commands. The ACTION#01_CMD through AC’ 
TION#09_CMD commands are all functionally identical. They 
allow you to designate up to nine (9) generic action commands 
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users can invoke to display customized text to other users in the 
chat channel 


ACTION#xx CONFIRM 

Actioa command continuation (response). This response is used 
to provide- a confirmation lo the user issuing the action command 
that the command was accepted and processed by UltraChat. 


ACTIQN#xx REMOTE 

Actiou command text shown to others (remote display). This is the 
text shown to other users in the chat channel of the user issuing the 
action command. 


Executing TBBS Menu Commands 


UltraChat offers the ability tu invoke TBBS menu commands from 
within the chat environment. These commands, called DQTBBS 
commands, may be familiar to existing TBBS sysops, since the 
capability exists in other TBBS option modules. These commands 
allow you lu tie an UltraChat command keystroke to the execution 
of a menu command type, by TBBS menu type number, just as you 
would from a TBBS menu. Up to nine (9) DOTBBS commands can 
be defined. 

DOTBBSfcxx_CMD Command 

DOTBBSftxxTYPE Other 

DOTBBS taDATA Other 

Where“xx” is the action command number from UL to 09 (see below 
for details). 


DQTBBS#Q1 CMP- DQTBBS#09 CMP 

Execute a TBBS command. The DOTBBS#01_CMD through 
UOTBBS#(K) CMD commands are all functionally identical They 
allow you to designate up to nine (9) command to invoke TBBS 
menu commands. The menu command type (TBBS Type= mim- 
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bcr) and Opt Data to use for the command arc specified using the 
appropriate command elements, discussed below. 

IMPORTANT NOTES REGARDING THE USE OF THESE 
COMMANDS: 

• A DOTBBS#sx_CMD command that normally would not return 
to UltraChat (any other option module, or types 5, 10 ,12, 35,43, 
or 45) are going to be marked as the user still being in UltraChat 
in any who s online displays. 

• Eventually, a return to UltraChat using the /E:4 Opt Data switch 
entry style should be performed. This will place the user back 
where they were when they executing the command, and will 
displayed all the messages queued up while they were out of 
chat. 

• D OTB B$# xxjCMD comm an ds will exit a user from one- to- one 
private chat before executing. 

• DO NOT EXECUTE A DOTBBS#xx_CMD COMMAND 
FROM WITHIN THETBBS READ PROMPT! THIS WILL 
CAUSE SYSTEM MALFUNCTION, INCLUDING (BUT 
NOT LIMITED TO ) SYSTEM CRASHES! 

IMPORTANT: .Anything that the user would normally have seen 
displayed while inside UltraChat is going to be queued while they 
arc in a DOTBBS command. For that reason, whatever happens 
should be kept short and swee t. 


DOTBBS#xx TYPE 

This element specifies LheTYPE = number of the TBBS command 
to execute. 


POTBBS#xx DATA 

This element specifies the Opt Data for the TBBS command to 
execute. 
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Moan Macros 


Moan macros in UltraChat arc similar to “action words” in Major 
BBS chat. A moan macro makes a certain word yield canned 
messages while in public chat. 

You define moan macros using a special command, 
MOAN MACRO, and a variety of command elements that are 
sent dependent on several criteria. 


A moan macro command is structured as follows: 


MOAN MACRO <word> 

DE FAULT RESPONS E 
[ DE FAULT_SEtJD3 
[IFU3ERRESPONSE 
[IF_USER_£ENDS_USER 
[IFUSE RESENDS 
[IF_MSG_RESPONSE 
[IF_MSG_SENDS 
[IF_US E R£MSG_RE S PONSE 
1 1FTJS E RSMSG_3 E NDS_U 3ER 
[IF USER6MSG SENDS 


<string> 

<string>] 

<etring>J 

<string>) 

<gtring>] 

<atring>] 

<atring>] 

<atring>] 

<string>] 

<3tnng>] 


The <word> is the moan macro text itself, and can be any single 
word of LO characters or less. The DEFAULTJRESFONSE ele¬ 
ment is required; all others are optional. 


To understand whaL the various elements do requires some ex¬ 
planation of how moan macros function. First, some definitions: 


default moan - user types just the moan macro word and nothing 

else (ie,, <c ydT% 


user moan - user types Lhe moan macro followed by a user name 
and nothing else (i.e.. '‘yell sysop"). 

msg moan - user types the moan macro followed by text that is not 
a user name {i.c., “yell tins stink*!”). 

user&msg moan - user types the moan macro followed by a user 
name and additional text (i.c., “yell sysop this stinks!”). 
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DEFAULT RESPONSE <String> 


Default response (response). The < string> is sent to the person 
that used the moan macro as a default moan. This, slibg is also sent 
to the user of the moan macro it' the appropriate *_RESPONSR 
string is not present for the type of moan macro used. This string 
is REQUIRED for all moan macros. 


DEFAULT_SENDS < string > 

Default remote display (remote display). The < string > is sent to 
all other users in the channel if the moan tin aero was of the default 
moan type. This s Lring is optional, and if not present when a default 
moan is used, the texL typed will he. transmitted to the conference 
as though it was not a moan macro at all 


IF USER RESPONSE <string> 

Response when user name or ID given (response). The < string > 
is sent to the person that used the moan macro as a user moan. This 
string is optional, and if not present when a user moan Is used, the 
DEFAULT RESPONSE will be substituted, 


IF USER SENPSJJSER <string > 

RemuLe display for specific user when user name or ID given 
(remote display). The <string> is sent to the user specified in a 
user moan. This string is optional and if not present, the user will 
instead receive the JF_U$EK_SENDS string. 


IF USER SENDS < string > 

Remote display for all others when user name or ID given (remote 
display). The < string > Is sent to all other users in the conference 
except the user that is the object of the user moan. This string is 
optional, and if not present when a user moan is used, UltraChat 
will instead convert the moan into a tnsg moan. 


IF MSG RESPONSE < String > 

Response when message given (response). The < string > is sent 
to the person that used the moan macro as a insg moan. This string 
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is optional, and if not present when a msg moan is used, the 
DEFAULT RESPONSE will be substituted. 


IF_MSG_$ENP$ < string > 

Remote display when message given (remote display). The 
< string > is sent to all other users in the conference when a msg 
moan is used. This string is optional, and if not present when a msg 
moan is used, the text typed will be transmitted to the conference 
as though it was not a moan macro at all. 


IF USER&MSG RESPONSE <String > 

Response when user name or LD and message given (response). 
The < string> is sent to the person that used the moan macro as a 
user&msg moan. This string is optional, and if not present when a 
user&msg moan is used, the DEFAULT_RESPONSE will be 
subsidised. 


IF USER&MSG SENDS USER < string > 

Remote display fur specific user when user name- or ID and mes¬ 
sage given (remote display). The <strings is sent to the user 
specified in a uscr&msg moan. This string is optional and if not 
present, the user will instead receive the IF USER&MSG SEND S 
string. 


IF USER&MSG SENDS < string > 

Remote display for all others when user name or ID given (remote 
display). The < siring > is sent Lo all other users in the conference 
except the user that Ls the object of the user&msg moan. This string 
is optional, and if not present when a user&msg moan is used, 
UitraChat will instead convert the moan into a msg moan. 

The following table will help show what strings get sent for various 
types of moans (strings are listed in precedence from top lo bottom 
or left to right). 
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*********** INSERT TABLE HERE ^fr*#******** 1 ®* 


Using Text In UltraChat Command Elements _ 

Command dements in UltraChat allow you to specify text. This text 
is .shown to the user executing a command, shown to a user at the 
receiving end of a command, shown to the user to prompt them for 
Input, or shown to the user in an error condition. In all cases, you 
specify text with the various command elements - this is their 
purpose. The general syntax is: 

< deuientuame > < string > 

Where <element_naroc> is the name of the command element 
(such as CHAT#0 L^EXlT) and < string > is the text to associate 
with that element. 

Text for command elements can be formatted a variety of different 
ways. The text always follows these rules: 

• Text must be contained in quotation marks. 

« When double quotes arc used to contain text, then embedded 
single quotes arc allowed. 

• When single quotes are used to contain text, then embedded 
double quotes are allowed. 

• Text can flow from line-to-lme if you follow the methods out lined 
later. 

• All carriage returns must be provided explicitly - UltraChat docs 
not insert any by itself. UltraChat will word wrap text displays 
automatically, however. 

• Text strings, as placed in the configuration flic, must be less than 
500 characters in length. When expanded by UltraChat 
(insenion parameters are inserted where needed), the text 
cannot be longer than 1,000 characters. 
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Wrapping Text Une-to-Une 

Text in command elements can span multiple lines if you desire. In 
order for UltraChat to handle this, however, you must format the 
text properly. 

The first line of the command element is handled just as though you 
we rc having text on only one line, except that there is no terminating 
quotation mark. Subsequent lines must be gin with a plus sign ( + ) 
as the first non-space character, which alerts UltraChat that the line 
is a continuation of a previous line. 

Yon can use a split bar (|, also sometimes called a “pipe 1 ’) to allow 
leading spaces iu the follow-on text, If you omit the split bar, then 
UltraChat will display the text beginning with the first non-blank 
character that follows the plus sign, 

Here is an example of a command element that spans multiple lines: 

chatmote ' "G%RUSER:C% ia requesting you join 
them in chat I 

+ Type "C M from the menu or "chat %ruser;c%'* 

+ | if already in chat to accept.'’M' 


Adding Carriage Returns and Control Characters 

As mentioned previously, any text in a command element must 
explicitly contain a carriage return (also culled a “newline 1 ') if you 
want one to be sen! to the user’s screen. If you fail to pul a carriage 
return at the end of command elements, the next thing UltraChat 
displays will be displayed immediately following (butted up against) 
the list text displayed. Sometimes this is what you want to occur - 
other times it is not. In any case, where you want UltraChat Lo begin 
or end a command element’s text display with a carriage return, you 
must put one in. 

Carriage returns arc specified with the characters ^ M That's a 
carat (^) followed by the letter M. This means Ctrl-M, which is a 
carriage return jo the ASCII character set. 

Here’s an example of the use of Lhe carriage return: 

HELP it 01 ERROR "Help file not found C'M’’ 
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The command element (an emir mss sage in tliis case) text begins 
with a double quote, followed by the text of the message, followed 
by A M, followed by a double quote. This command element will 
be sent with a trailing carriage return when sent to a user. Carriage 
returns can come at the beginning or be embedded in the middle 
of text, too. 

Other control characters can be specified the same way. You could 
embed a “bell” (Ctrl-G) character in the above text like so: 

HELP#01 ERROR "''G'GHelp file not foundI*H" 

This example begins with u double quote, followed by a pair of 
sequences before the rest of the text. This will scud twe bells, and 
cause most users' terminals to beep twice when this text is sent. 

Here is a table of control characters: 


a= son 

~l = Tab 

^Q = DC1 

~Y = EM 

B-STX 

A J = LnFeed 

~R=DC2 

/S Z = SUB 

C-ETX 

^K=VTab 

~S=DC3 

^ [ = Escape 

D = EOT 

^L-FmFeed 

/S T = DC4 

^\ = FS 

E-ENQ 

^ M = Enter 

^ U = NAK 

^J = GS 

F-ACK 

A N = SO 

~ V-SYN 

~ “ -RS 

G=Bell 

~o=si 

^ W = ETB 

A =us 

H = Bksp 

a p=dle 

^X=CAN 

~@=:Null 


Adding ANSI Escape Sequences 

UltraChal allows you to colorize comm ami eleme nt text displays 
with ANSI escape sequences, just like TBBS itself. ANSI escape 
sequences always begin with an Esc (Escape) character, followed 
by a left square bracket, followed by the contents of the ANSI 
sequence. Toward the end of Chapter 2 of the TBBS manual, you 
will find a complete ANSI escape sequence charl you can use to 
look-up possible ANSI codes. 

InUllraChat (as well as most areas of TBBS itself), y nu designate 
an Escape character with a carat and a left square bracket, like this: 
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ANSI escape sequences then, have Ihe following appearance within 
Ihe Ultra Chat configuration file: 

The carat and fust left square bracket mean “Escape." The second 
left square bracket is a part of every ANSI escape sequence. The 
remainder of the sequence is the ANSI command contents, in this 
case a color (attribute) change command. 


Restricting Configurations Within UltraChat 

[.ike many eSofl products (TIMS, QSO, Interchange, etc*), Ultra- 
Chat provides restrict blocks that allow yon to control to whom any 
portion of the configuration applies. For example, you can have 
some UltraChat commands available only to some users (sysops, 
co-sysops, super-users, etc.), Or, provide a named conference for 
users who call on certain lines odL}\ Ynu have complete control over 
configurations via restrict blocks. 

If you have used restrict blocks in other cSoft products, you already 
know how to use them in UltraChaL A restrict block begins with a 
RESTRICT verb, and ends with an ENDRESTRICT verb. The 
general form of the construct is as follows: 

RESTRICT <restrict ion> _. 

(normal ultrachat config stmnta hers) 
ENDRESTRICT 


RESTRICT statements can be nested to any number of levels. This 
allows changing UltraChat configuration based on any or all of 
several restriction parameters. 

IMPORTANT NOTE: IF A STRING (ie, something like 
WHO#Gl_TEXT) IS CHANGED, ONLY THE FIRST ONE 
THAT IS FOUND VALID FOR A USER WILL BE USED! This 
is important because in some cases a user may qualify under 
multiple restrict statemeats, but only the first occurrence of a string 
will be stored and used for that user. Because of this, puL your 
MOST restrictive slulcments at the lop of the file, and the least 
restrictive at the end of the file. For example, SYSDF restrictions 
might go first, while ALL strings might have a default that goes last 
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In the file and will be used if no other text was previously defined 
for that type, 

The various < restriction > types are: 


A1 - <flag> A2- <flag> A3~ <flag> 

A4- <flag> 

These four restrict types allows you to restrict based cm TBBS 
access flags, where <flag> is of the usual SDL format (ie, 
A1=X..--X.X). 


P#= <param> 

This restrict type allows you to restrict based on a parameter passed 
tnUltraChatfromthe Opt Data line of the menu entry that invoked 
UllraChat. The # is 1-9 to match the parameter number pcissed to 
UUraChaL The <para.m> parameter contains tact that much 
match the passed parameter exactly. Use quotation marks around 
the <param> text if it contains embedded spaces. Parameters can 
be up to 16 characters in length. 


GROUP = < group > 

This restrict type allows you to restrict based on group. The 
< group > is a 4 character identifier that should mutch thc/G:abcd 
that this person was last given (ic, GROUP = MEN). Groups arc 
defined with the Opt Data line of the menu entry that invoked 
UltraChat. 


NAME= <name> 

This restrict type allow'.? you to restrict bused on user name or ID. 
The < name > is a user name and this RESTRICT statement is only 
valid for that particular user. In most Cases this will be used as 
NAME = SYSOP to give special functions to the sysop, although it 
can easily be used to give n certain user a special thrill, 
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LINE ~ < lines > 

This restrict type allows you to restrict based on TBRS line number. 
The < lines > can be a single line number, a range of line numbers 
(ix., LINH = 1-8) or any combination of line numbers and ranges 
separated by commas (i.c., L INE = 1,3-6,9,11-22). 


LANG = <c> 

This restrict type allows you to restrict based on TBBS language 
selection. The < c > is a character corresponding to the language 
you wish lo match- If the language the user has enabled is NOT 
< c >, then the RESTRICT is not used. Languages are lettered A, 
B, C, etc. 


PRIV < conditional > <prfv level > 

This restrict type allows yon to restrict based on a user’s privilege 
level The <conditional> is any combination of <, > and = to 
term things like > = tor greater than or equal to, < > for not equal 
to, and so on. The <priv_lcvcl> is the privilege value that should 
be used for comparison. 

For example, PRIV> =511 will pass for anyone with a privilege 
greater than or equal lo 5(1. Uy nesting RESTRICT blocks, ranges 
Can be created, for example: 

RESTRICT PRIV>=5Q 

RESTRICT PRIV<*100 

(stmnts here for 50<=priv<=100> 
EHEi RESTRICT 
ENDRESTRICT 


BAUD < conditional > ebaud rate> 

This restrict type allows you Lo restrict based on the baud (bps) rate 
a user is connected at. The ^ cotiditiOHcil is us it is for PRIV 
(discussed previously), and < band rate > is any valid TBBS band 
(bps) r ate that can be set in CEDIT. The result codes from Lhe right 
side ol the (JEOiT result code table is used if it exists, otherwise 
the left side is used. Valid baud rales are currently things like 2400, 
9600, and 19200-but NOT thing? like 12000,14400, or 28800- One 


3-S9 




Chapter 3; Command Reference 


special case is that the local console is assumed to he baud rale 
999999, 


DAYS - < day > 

This restrict type allows you to restrict based on the day of the week. 
The <dav> parameter can be SUN, MON t TUE, WED, THU, 
FR1, or SAT, corresponding to the days of the week from Sunday 
through Saturday. You can also use the day names in verbose form, 
such as SUNDAY or THURSDAY for readability. 

Two special “days” also exist: WEEKEND and WEEK, which 
correspond to SAT and SUN for WEEKEND, and MON through 
FR1 for WEEK. 


DATE = < date > 

This restrict type allows you to restrict based on calendar date. The 
< date > parameter is of the format MM/DD/YYYY, where MM 
is the numeric monlh from 1 to 12, DD is the numeric day from 1 
to 31, and YYYY is the year in standard 4-digit format (c.g., 1994). 

Y'ou can replace any of the digits normally expected with, an asterisk 
(*) which, like a DOS wildcard, means “any.” For example: 

RESTRICT DATE=G4/01/**** 

Will pass on April Fool’s Day (April 1st) in any year. 

RESTRICT DATE=+*/01/**** 


Will pass on the first of any month, any year. 
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Nesting Restrict Blocks 

RESTRICT blocks can bet nested, allowing you to create restric¬ 

tions Klee the following: 

RESTRICT Al-XXX- 

cstatements for all Al-XXX- people> 

RESTRICT A 2 =... - 

otmnts for Al=XXX--) 

ENDRESTRICT 

RESTRICT A2=XXX- 

<stmnts for Al-XXX-A2-XXX-) 

ENDRESTRICT 

ENDRESTRICT 

Because RESTRICT blocks can bemme very long if a. Lot of types 
of restriction are used, it is often necessary to split them onto 
multipie lines of text. To do that, simply start the next line with 
RESTRICT and make sure the proper number of 
ENDREvSTRICT statements are also in place, This works because: 

restrict <restrictl> crestrict2> 

ENDRESTRICT 

Ls the same as: 

RESTRICT <reetrictl> 

RESTRICT <restrict2> 

ENDRESTRICT 

ENDRESTRICT 

Nested. RESTRICTS are the same as using an "‘AND” statement, 
while sequential RESTRICT statements are separate entities. 
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Insertion Parameters 


Insertion parameters play an integral role in virtually all command 
dements in the UltraChat configuration. Insertion parameters 
allow text displays to show user names, chat messages, and much 
more. What good would a who's online display be if it didn’t show 
user names? Insertion parameters allow you to configure who's 
online displays so they have user names. Wbat good would a facility 
to send a private chat message to somebody be if the user receiving 
the command couldn’t see anything? Here again, insertion 
parameters allow text displayed by UltraChat to show this informa¬ 
tion and much more. 

One of the most Important concepts of insertion parameters to bear 
in mind is that of perspective. In TBBS, you never have to worry 
about this - in UltraChat, it is of critical importance. 

Within the UltraChat configuration, all command element text is 
from the perspective of the user printing the text string, For ex¬ 
ample, let’s say user A sends a private chat message to user B. The 
configuration is from the perspective of user A for text strings 
printed to him, and from the perspective of user B for text strings 
printed to him, 

User B in this scenario is called the target user or remote user, and 
receives a remote display. 

Insertion parameters must be carefully used then to ensure that the 
right user receive the right type of information. For example, in this 
scenario, the %L1NE% insertion parameter would return user A‘s 
line number, while %RLINE% would return user B’s line number 
when the string is printed to user A, (he reverse is true for strings 
printed to user B. 

Note the letter "R” in the insertion parameter’s name - this means 
remote and can be used as a rule of thumb to denote insertion 
parameters that refer to the remote or target user in any given 
command scenario, 








f 
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Insertion Parameter Formatting 

Insertion parameters are of the form: 

% P AR AM [ ;J -J* /-)n [U,L,C])9& 

This means that the parameter can be optionally followed by a 
formal specifier. If no format specifier is present, the parameter is 
printed unchanged and takes a length equal to whatever length the 
parameter cdAs up being. If a format specifier is present, it is 
signaled by the parameter being followed by a colon (:), then an 
optional justification parameter. 

The default justification parameter is LEFT justified and cor¬ 
responds lo u minus (-) symbol in this position. If a plus (+ ) is 
found in this position, the string is tilled on the left lo make it 
RIGHT justified. 

Next is the length of the siring. The default if not present is to end 
the stiiug without padding it. If a number is present here, the 
insertion parameter will be truncated or padded to fit the given 
length. By default, if ihe string needs to be padded, it will be 
padded with blank spaces. 

If the string length parameter starts with a V t the string will be 
padded with 0’s instead. The last optional parameter is one of U, 
L, or C, which corresponds lo the “case” of the final result. By 
default, no alphabetic case translation is done to the string. If U is 
specified, the string is converted to all upper case, L converts to all 
lower case, while C converts to a mixed case format. 


%USER% 

%T[MELEFT% 

%NOTES% 

%ADDR1% 

%ADDH2% 

%crry% 


General Insertion Parameters 

The user’s fall name. 

The amount of lime left for this call. 

The user’s NOTES field from the uscrlog. 
The user’s ADDRl field from the userlog. 
The user's ADDR2 field from I he userlog. 
The user’s CITY field from the uscrlog. 
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%STATE% 

%ZIP% 

%PHONE% 

%COL)NTRY% 

%LOCATICN% 

%3UNEBIO% 

%LASTQN% 

%L0GINS% 

%TIMEUSED% 

%FIAGS% 

%ANNOUNCE% 

%LINE% 

%CHANNEL < % 


The user's STATE field from the userlog. 

The user's ZIP field from the userlog. 

The- user’s PHONE field from the userlog. 

The user’s COUNTRY field from the userlog. 

The user’s location, 

The user's Ihree-line bio. 

The user’s last logon date and time as: MM/DD/YY 

The number of times the user has logged on. 

The amount of time a user has been logged on NOT counting the 
current call. It is in hours;MM formal where hours can be up to 5 
digits long. 

Prints strings for WHO#02_TEXT, WHO#G3_TEXT and 
WHO#(J4_TEXT if user qualifies. 

The user’s announce string (if am 1 ). 

The user’s line number. 

The user’s current channel number. If the user is in a named 
conference, the conference name is displayed. 


%MINCHANNE L% Lowest public channel number allowed 
% M AXCHA NNE L% Highest public channel number allowed- 
%SY$TEM% The SYSTEM NAME TEXT string (BBS name). 
%SYSTE M [ D% The SYSTEM ID TEXT string (BBS ID text). 

%SYSOP% The SYSOP NAME TEXT string (sysop’s name). 


%USTED% 


Number of lines listed in WHO#01 CMD or WHO#02_CMD 
display. 


%LASTLINE% 


Number of lines in system. 




%MSG% 

%TYPED% 

%fS/ARE% 

%VEHSION% 


%TOPJC% 
%PA$SWORD% 
%P1% -%P9% 
%NUMCMDS% 

%FREETE)Cr% 

%TIME% 

%DATE% 

%EURODATE% 

%WAITING% 

%IGN0RED% 

%INVITED% 
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Chat message to be senL (used by private paging and cliat com¬ 
mands, among others). 

What the user typed in its entirety, designed to allow an entire user’s 
typed command to be echoed back if desired. 

Valid in ‘totals’ 7 lines for WHO commands and prints I$_TEXT 
or ARE TEXT depending on if the number of users listed by the 
comm and was 1 or more than 1. 

Ret urns n a tnc of program and current version nu m ber in the form: 
UltraChat Version 1.00<.xx> 

where the jo: will show mod level when mods are issued. 

User’s private channel topic siring (if any). 

User’s private channel password. 

User’s passed parameters 1 through 9, 

Number of UltraChat commands available for “this” user (inde¬ 
pendent of how many maybe configured). 

The amount of free memory space available to hold UltraChat 
commands for “this” user. Useful for diagnostic purposes. 

Thu current dock time in HH:MM format. 

The current calendar date in MM/DD/YY format 

The current calendar date in DD/MM/YY format. 

Displays the contents of the YVAiTINGTEXT configuration 
statement only if a user has mail in TBBS waiting for them. 

Displays the contents of the TGNORED TEXT configuration 
statement only if the user being referred tv is being ignored. 

Displays the contents of the 1NV1TEDJTEXT con figuration state¬ 
ment online it the user being referred to has been invited to a private 
channel. 
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Remote (Target) User Insertion Parameters 


%RUSER% 

%RNOTES% 

%RADDHl% 

%RADDR2% 

%RCITY% 

%RSTATE% 

%RZIP% 

%RPHONE% 

%HCOUNTRY% 

%RIOCATION% 

%R3UNEBIO% 

%RLASTON% 

%RLOGINS% 

%RTIMEUSED% 

%RFLAGS% 

%RANNOUNCE% 


The following insertion parameters refer to the “current” remote 
line. Tn the case of who’s online displays, this is the information fox 
the next line to be displayed by the who’s online display command. 
Tn other cases, such as user to user private messages, it refers (t) the 
remote user or the user who is the target of the co mm and, as 
outlined previously. 

Remote user's full name. 

Remote user’s NOTES field from the useriog 

Remote user's ADDR1 field from the useriog 

Remote user’s .A DDR2 field froni the uscrlog 

Remote user’s CITY field from the useriog 

Remote user’s STATE field from the user log 

Remote user’s ZIP field from the uscrlog 

Remote user’s PHONE field from the- useriog 

Remote user’s COUNTRY field from the useriog 

Remote user’s location 

Remote user’s three-line bio 

Remote user’s last logon date and time as; MM/DD/YY 

Remote number of times the user has logged on. 

Remote amount of time a user has been logged on NOT counting 
the current call. It is in hours:MM format where hours can be up 
to 5 digits long. 

Prints strings for WHO#02_TEXT, WHO#(13_TEXT and 
WHO*04_TEXTif remoLe user qualifies. 

RemoLe user’s announce string (if any). 
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%RCHANNEL% 

Remote re mote user’s channel if in chat (# or P# if in private chat). 
If the user is in a named conference, the conference name is 
displayed. 

%RUNE% 

Remote user's line number. 

%RCOMMAND% 

%R COM MAND %[ r commandJRemote user’s command be inn 
run. Will print ““CONF: < name > " for named conference. 

%RMSG% 

Message sent from the other line. 

%HT0PIC% 

Remote user’s private channel topic string (if any). 

%RP1%-%RP9% 

Remote User’s passed parameters 1 through 9, 


User log Image Insertion Parameters 


The following insertion parameters work on a userlug image from 
disk. The us&rlog record used for these is that of the user initiating 
the related command. Any command that prints things from the 
userlug (WHO#03_CMD for example), should use Lhese 
parameters for printing the desired information: 

%UUSER% 

The. user’s full name. 

%UNOTES% 

The user’s NOTES field from the userlug. 

%UADDR1% 

The user’s ADDRl field from the uscrlog. 

%UADDR2% 

The user’s ADDR2 field from the uscrlog. 

%UCITY% 

The user’s CITY field from the user log. 

%USTATE% 

The user’s STATE field from (he user log. 

%UZIP% 

The user’s ZIP field from the uscrlog. 

%UPHONE% 

The user’s PHONE field from the uscrlog, 

%UCOUNTRY% 

The user's COUNTRY field from the user log. 

%ULOCATION% 

The user’s location, 
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%U3UNEBK)% The user's three-line bio. 


► 

> 

i 


%ULASTON% 

%ULOGINS% 

%IJTIMEC$ED% 

%UFUGS% 


The user’s last logon date and time as; MM/DD/YY HH:MM 

t 

The number of limes the. user has logged on. 

The amount of time a user has been logged on NOT counting the 
current call. It is in hours:MM format where hours can be up to 5 
digits long 

Prints strings for WHO#fi2_TEXT, WHG#03_TEXT and 
WHO#04 TEXT if user qualifies. 



Sec the sample UCHAT.CTL file for how these parameters can be 
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Glossary 


action commands This term refers to a set of special commands within the chat 
environment. Act iou commands are a form of generic moan macro, 
In Major BBS chat, this is usually called a “generic action” or “CA” 
command, in essence, an action command allows a user to create 
on-the-fly a special, tailored remote display that will he shown to 
all the users who are in the channel with the user who issued the 
action command. In most ways an action command is the same as 
a user simply typing something Into the chat channel - but the 
remote display is different, formatted as though the user issued a 
moan macro. 

announce string The announce string is a uscr-scttablc vanity item that can be shown 

as part of who’s online displays (or other UltraChat displays), ft is 
often, applied as a customized greeting or remark by a user. 

bio See three-line bio. 


chat environment This term refers to any point at which the user is under the control 

of UltraChat, Who’s online displays, public chat, private chat, and 
so on all collectively constitute the chat environment. Any function 
a user performs online with TBBS that is not under the control of 
UltraChat is not a part of the chat environment, 

chat traffic This term refers to the messages, pages, private comments, and 

other commands issued by a user which result in a display befog 
made on another user’s screen. While within the chat environment, 
anything that a user types lhaL results in a display on the screen(s) 
of one or more users is considered chat traffic. Not all operations 
within the chat environment create chat traffic. For example, a 
who’s online display is not considered chat traffic because the 
results of the command arc shown only to the user issuing the 
command, and not to anyone else, 

command A series of one or more keystrokes issued by a user within the chat 

environment to cause UltraChat to do something. Commands in¬ 
clude such things as who’s online displays, channel change, paging, 
private messages, and so on. 


command element The text associated with a particular UltraChat command. Ele¬ 
ments include responses, remote displays, prompts and error mes¬ 
sages. 
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command element 
sharing 

error message 

groups 


handle 


ignore 


A technique for economizing the use of memory by buying (wo or 
more command elements share the identical text, 

This is one of the primary command elements in UllraChat. An 
error message is shown to a user issuing a chat command when the 
command is improperly formatted, references a user not logged to, 
etc., to alert Ihe user to the fact that they made a mistake to the 
issuance of the command 

This term refers to an UllraChat feature that allows you to separate 
users into Logical groups. When yon force a user to become part of 
a group, that user can only interact with other users in his group for 
any UltraChal related functions: who’s online displays, will only 
show users in his group; he will be able to page only users in his 
group; in a public channel a user can only chat with people in his 
own group; and so on. 

IMPORTANT: Groups do not apply to users who arc not online. 
Who’s online and other displays which reference information from 
the userlog file (any insertion parameter that begins with a %\J) 
will display the user whether they would normally be a part of the 
group or not. To limit display of this information, you must use the 
MATCH^USERLOGFLAG configuration statement to control 
this outside or the grouping construct. 

This term refers to an identifier that overrides the name or ID of a 
user within the chat environment. J n essence, a handle is a replace¬ 
ment user name or ID set exclusively for use within chat, ll is 
primarily of interest. to systems who require users to logon with their 
own real names, but want to offer anonymity to their users when 
they use chat. A handle will be used for any displays and commands 
within the chat environment, such as who’s online displays, paging 
commands, three line bio displays, etc. 

This term applies to the stale other users can be in within the chat 
environment from the perspective of a particular user. When a user 
is inside the chat environment, they can mark specific other users 
as being ignored. When another user is ignored, their chat traffic is 
not displayed until they are remembered again. All the ignored 
users' chat traffic is suppressed, including private messages and 
public messages as applicable, as if ihe ignored user wasn't sending 
any chat traffic. Other users in the chat environment still see the- 
traffic of the ignored user (unless they too explicitly ignore that 
user). This is the opposite of remember. 
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input buffer 


invisible 


invite 


no chat 


one-shot 


private message 
queue 


This term refers to a memory buffer (a storage area in memory) 
where keyslrukes from a user are stored before being acted upon 
by TBBS. Whenever a user presses a key during a BBS session, it 
is placed in the input buffer. Whenever TBBS is able to process a 
key, it re moves the first one available in the input buffer, Ordinarily, 
this processing of the input buffer lakes mere microseconds, and Is 
totally transparent to the user. 

't his term applies to a particular state a user can be in within the 
chai environment. When a user is marked as invisible, they wlJ not 
show-up on who’s online displays (unless configured specifically to 
show-up there), and will clherwi.sc be treated by UltraChat as 
though they arc not online. The state of the invisible setting can be 
forced upon a user (as it often is for new users to your BBS), or if 
you allow it, can be user settable (a user can mark themselves 
invisible or visible). 

This term applies to private channels, and refers to a situation 
where a user permits / requests that another user join him in his 
own private channel. When another user is invited, they are per¬ 
mitted to change to the inviting user’s private channel at their 
leisure. This is the opposite of uninvite 

This term, also given in some cases as the single word “nocliat”, 
refers to a particular state that a user can be in within the chat 
environment. When a user is marked as being In no chal mode, 
UltraChat will internally understand that the user is not available 
for chat. As such, private messages, paging, and other chat traffic 
is not sent to a user who is in no chat mode. 

This term refers to the execution of a specific, single UltraChat 
function from a TBBS menu entry. When the one-shot is executed, 
the UltraChat function runs, then returns control to TBBS imme¬ 
diately after ward. This allows UltraChat operations, such as a 
handle change, user page, who command, etc,, to be executed from 
a menu entry without entering a public chat section. 

This term refers to a storage place lor private messages. UltraChat 
creates a private message queue on a user-by-user basis. When 
private messages are received fox a user (private messages being 
things like chat pages, logon announcements, etc.), but the user is 
not wi thin a window of opportunity, the messages arc .saved in the 
private message queue. The next time the user passes a window of 
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prompt 


remember 
remote display 

response 

target 


three-line bio 


typaehead 


opportunity, the private message* that have been queued up are 
then displayed to the user’s screen. 

This is one of the primary command elements in UltraCbal. It refers 
to u prompt or question given to a user in conjunction with that 
user’s issuance of a chat command. Prompts simply request addi¬ 
tional information from the user issuing the command, such as 
which user the command affects, what message to send, and so cm. 
For example, a user issuing a page command migh t see a prompt 
to enter the name of the user they wish to page. 

The opposite of ignore; see "ignore” for details. 

This is one of the primary command elements in UltraChat. It refers 
to text shown to a user (or users ) who is the “target” of a chat 
command issued by another user. For example, if user A send a 
page command to user B, user B will receive a remote display that 
indicates that user A is paging him. See also: response. 

This is one of the primary command elements in UltraChat. It refers 
to text shown to a user as a result of that user's issuance of a chat 
command, Responses generally serve to confirm with the user that 
UltraChat received and processed the command. See also: remote 
display. 

This term applies to many UltraChat commands, and refers to the 
user who is at the receiving end of a command. For example, if user 
A pages user B, user B Is said to be the target of the command.Not 
all commands in UltraChat have a target, for example, a command 
to exit the chat facilities has no target. In rare cases, the targeL may 
be multiple users (for example, a user issues an invite command to 
ALL” instead of a specific user). 

This term applies to a feature of UltraChat whereby users cun place 
information about themselves. In most situations, the three-line bio 
contains personal statistics about the user; such 3s height, weight, 
etc.; but since the user enters the three-line bio themselves it can 
contain anything the user wishes. The three-line bio is stored by 
UltraChat, and can be. made available to other users with specific 
commands, on who’s online displays, etc. 

This term refers to keystrokes that a user has made., but which TBBS 
(and/or UltraChat) have not yet acted upon. These arc keys that 
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have stacked up, i.e., keys Lhat have been typed ahead, hence the 
term "typeahead” 

uninvite This term applies to private channels, and refers to a situation 

where a user no longer permits or kicks out another user from his 
own private channel. When another user is uninvited, they are no 
longer permitted to change to the uninviting user's private channel, 
and if they are already in that private channel, they are removed 
{kicked out). This is the opposite of invite, 

Visible The opposite of invisible; see “invisible 1 ' for details. 

wind 0 W of This t erm applies to moments in the passage of lime d or mg a user's 

opportunity BBS session where they arc brought into the chat environment for 

a brief moment in order to receive chat traffic. When within that 
window, a user can receive chaL traffic such as logon an¬ 
nouncements, private paging messages, etc, "When outside the win¬ 
dow, a user cannot receive chat traffic. For example, a user who is 
running a TDBS application or downloading a Eic is not within the 
window of opportunity’, and therefore, cannot receive any chat 
traffic from liltraChat until they again cater a window' of oppor- 
tun ity. Windows of opportunity i ndud c a brief moment when TBBS 
loads a menu, and anytime a user is silting at the message read 
prompL while reading messages,. 

NOTE: Whenever a user is within chat, whelher public or private, 
they are also inside a sort of large, extended window of opportunity 
and can receive all chat traffic at any time while in chat. When 
outside of dm, chat traffic is only received when the user passes 
through a window’ of opportunity. Tn chat, the window is only open 
when at the prompt, and not while the user is typing a command. 




Appendix B; Technical Limits 



Technical Limits of UltraChat 


The following technical limits apply to UltraChat: 

Each defined command can have up to 14 characters of command 
text (the command the user types to execute the command). 

Named conferences can have names up to 30 characters long, 

A DOTBBS command can use- a maximum of 100 characters of Opt 
Data. 

There can he a maximum of 12,000 bytes of text strings active for a 
user. This is combine d sum of the length of all command strings and 
command response strings (but does not include moan macros), 

A maximum of 65,53(1 numbered conferences can be defined, 

A m axi m um of 65,536 named conferences can be defined, of which, 
only 50 can be active for a user at auy one given lime. 

Moan macros can be a maximum of 10 characters in length. 

A maximum of 512 moan macros can be made available. 

Parameter strings (those designated with Lhe /Pn:< string > Dpt 
Data switch) can be a maximum of 16 characters in length. 

A maximum of 10 lines (users) can be “highlighted” with the 
highlight command at any odg lime, 

Announce strings can be a maximum of 80 characters in length. 

A three-line bio can be a maximum of 255 characters in length, 

A user’s private channel topic (the name he gives for his private 
channel) can be a maximum of 24 characters in length. 

Passwords for private channels can be a maximum of 16 characters 

in length. 

Handles can be a maximum of 20 characters in length. 
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Appendix B: Technical Limits 


The user command portion of a who's online display (customized 
text to define the place a user is online, set with the /D: Opt Data 
switch) can be a maximum of 30 characters in length. 
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